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SECTION 1: GENERAL INFORMATION 



The Texas Itirti^atnwt^ Editdr/A«iemWw^ ^otM jtefttW j^ltware Command Module 
and accompanying diskettes allow you to write programs in the powerful assembly 
language of the TMS9900 microprocessor built into the TI-99/4 and TI-99/^A Home 
Computers. This assembly language has all of the features expected from an 
advanced microprocessor, including both byte- and word-cnriented commands^ 
auto-incrementing capability, and a variety of addressing modes. 

Your Editor/Assembler package contains a command module, two diskettes (labeled 
Part A and Part B), this manual, overlays for your computer, and a manual for a 
game or application program. The command module controls the Editor/Assembler 
and must be inserted in the console to use the features described in this manual. 
The diskette labeled Part A contains the Editor, the Assembler, TI BASIC support 
routines, and both source and object code for the Debugger. The diskette labeled 
Part B contains the SAVE utility, which allows you to save programs in memory 
image format, and the source and object code for a game or application program that 
can be usdd m m example. 

The use of assembly language instead of a higher-level language such as BASIC or 
Pascal has several advantages. The execution of assembly language programs is much 
faster. In addition, assembly language gives you access to all machine resources, 
including functions not available from higher-level languages. 

Compared to writing programs in machine language, assembly language is much 
easier. The instructions are mnemonic codes, which are easier to use and remember 
than the symbols of object code. In addition, you use expressions as operands and 
may use decimal numbers in expressions and as operands. Furthw, the use of 
assembly language rellevi» you of the tedious taste of writing machine language 
instructions and keeping track of binary machine addresses within the program. 

This manual provides details on creating, editing, assembling, and running assembly 
language programs on the TI Home Computer and includes explanations of the 
following. 

• The use of the Editor. 

• All TMS9900 assembly language instructions and pseudo-instructions. 

• Assemble output. 
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• The utilities provided for reading from and writing to VDP RAM. 




• The utilities provhM "fir il^eMllig the Qraphte P%priMMN3' 

subroutines. 

• The seven ad^tldM TI BASIC sutooutMs inclt^ed trt the Editor/AssemHer 
Command Module* 

• The utilities for communication between assen^y language programs and TI 
BASIC programs. 

• The use of the EMtmgger program. 

• The use of sound, color^ t^aphlcs, and i^eech from assembly language 



The SimpleBt corrl^^Qnt^dn running Editor/ Assemblir reqditcitt the TI Home 
CUmputeTy the TI Memory Expansion unit, the TI Color Monitor (or the TI Video 
Modulator and a television set), the Editor/Assembler Command Module, the 
Editor/Assembler diskette, and a TI Disk Memory System with at least one Disk 
Memory Drive. With this equipment you can either develop programs of your own or 
tm HiM^ itvient^ liHigiiagv programs. To enhance your system, you may want to 
wM. %9 ^SUSl {nterfapey additional disk drivest or other periph^ls avedlable from 
Texas Imfirunnenu. 

The Editor in the module allows you to create, edit, print, and save files. Several 
commands make file preparation as simple as possiSble. After a program ^le been 
created, you can assemble It with the Assembler in the module* 

The Assembler reads a source file prepared in the Editor and produces object code in 
one of two formats and error messages. It can list the assembled program. 

After a f Ue Nm been membledi you fi»y lead and run it. The Debu^OT ^<o^^ 
can help )^ 6i and correct any errors which may occur. When the program Is 
satisfactory^ you can save it with the SAVE utUUy so that you can easily rtm It as 
needed. 




programs. 
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GENERAL IMT3RMATION 



la USING THIS MANUAL 

This manual assumes that you already know a programming language, preferably an 
as^mbly Saiif^d* If 3^ £ld noty there are many fine books available which teach 
the ba^^ of assembly tengm^ mOm After you know these basics, this manual gives 
the details of TMS9900 ^iefilbly language and its appilGation to the TI Home 
Computer. 



Whm tmm iiat may be new to you are first used, they are dtlt^^d. (If fm WHtirt to 
review a definition tester, a Olessary Is imvidad near th» of the manual.) Section 
2 explains the basics of using the Editor/ Assembler. Sections 3 through 15 are a 
detailed description of the TMS9900 assembly language and assembler output. The 
remainder of the manual describes applications specific to the TI Home Computer, 
such 88 access to utilities, BASIC support, file management, the linking loader, the 
debugger utility, and the use of sound, col<^, graphics (including sprites), and speech. 

Several appendices provide other useful information, including a description of the 
number bases used, the character sets available, the instructions, and related 
information. 
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GEhCRAL INFORMATION 



1.2 SET^ INSTRUCTIONS 

Use your Disk Manager to make baj^Ufl copies of ^ t^sl^^es si^tifld with your 
Editor/Assembler. You may use those copies for your own use. The wiginaU should 
be kept in a safe place. 

before yot| mB ^ EAor/Assembier, the Memory Es^j^nsion unit and the TI Disk 
Memp^ iyitai mtfSt profser^ ettaoM 1^ £Nr CEompt^iBr and turned on. See the 
appropriate ov^ner^s manuals for complete set-up instructions. 

An automatic reset feature is built into the computer so that when a module is 
inserted into the consde the eon^iuter s^uvm to the maaiar title screen. AU dlttiB 
or pro^em material you have entered is erased* 

CAUTION 

To avoid damaging the module, be sure it is free of static 
electricity before inserting it into the computer. Touch 
any metal db|ec:tt such as a door knob or desk lamp, before 
haru^g the module. Kee^ the mx»dule clean and dry, and 
do not touch the recessed contacts. 

1. Slide the command mc^kile iltto 1^ ^ot on the console. 

2. Turn on all peripherals. Turn on the computer. 

3. Insert the diskette labeled Part A into Disk Drive 1. 

4. Press any key to make the master selection list appear. To select the module, 
press the key corresponding to the number beside EDITOR/ASSEMBI-ER. 

Note: If the diskette is not inserted prior to using a function requiring the diskette, 
you may have to turn the computer off, insert the diskette, and start over. 

To remove the module, first return the computer to the master title screen by 

pressing <quit>. Then remove the module from the slot. If the module is 
accidentally removed from the slot while the module contents are being used, the 
computer may behave eratically. To restore the computer to normal operation, turn 
the computer console off and wait a few seconds. Then reinsert the module and turn 
the computer on egain. 
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If you have two or three disk drives, it is best to leave the Editor/Assembler diskette 
in Disk Drive 1 at all times and put your program diskette in Disk Drive 2 or 3. If 
you have one drive, then you inu^ Mthra^ k^p ^ that you create and edit on 
the Editor/ As8dfnl»ler diakcto or ditonate putting the EM^fAasembleir diskette ai:id: 
your program diskette in the drive. When you need to load, edit, save, print, run 
a file from another diskette, first wait until the necessary portion of the 
Editor/Assembler has been put into memory from the diskette. Then replace the 
Editor/ Assembler diskette v/ith the one that has yoiff fil* 05 It, After your ftle hm 
been loaded, edited, saved, printed, or run, remove your program diskette and replace 
it with the Editor/ Assembler diskette. 



1.2.1 In Case of Difficulty 

If the Ec^ior/Aisennblw does not sppew to be opwatfing properly, remove the diskette 
and return to the master title screen by pressing <esc>. Withdraw the module and 
remove the diskette from the disk drive. (Note: In some instances it may be 
necessary to turn the computer off, wait several seconds, and then turn it on again 
before proceeding. Always rernoira diskettas before turning yoiff computer on or Off.) 
Next align the module with the module opening and reinsert it carefully. Then 
reinsert the diskette. Now press any key to make the master selection list reappear. 
Repeat the selection process. 

If you have any difficulty with your computer or the Editor/Assembler module, please 
contact the dealer from whom you purchased ttie unit and/or module for service 
directionB. Additional information concerning service can be found in the User's 
Reference Guide. 
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1.3 SPECIAL KEY FUNCTIONS 

On the TI-99/4 console, certain keys 80^ liiiEi tei eaflBMr»tto« Vil'&i ttm 1^8, 
On the TI-99/4A console, certain keys are used inl coiT*ination with fehs FCTH feeya* 
Pressing any key for more than a moment causes that key to be repeated. Note: 
The Editor/Assembler accepts lower-case letters from the TI-99/4A only in comments 
and text. For this reason, it is usually best to keep the ALPHA LOCK key pressed 
down. The {, }, [, and ] keys are not itt^l^le on the TI-99/4, 

The following table llsU the special keys available when L»ing the Editor/ As^mbi^. 



Name 


TI-99/4 


TI-99/4A 


<del charactBr> 


SHIFT F 


FCTN 1 


<ins ^aracter> 


SHIFT G 


FCTN 2 


<delete line> 


SHIFT T 


FCTN 3 


<roil-up> 


SHIFT C 


FCTN 4 


<next-window> 


SHIFT W 


1 N -) 


<rt>Il-down> 


SHIFT V 


FCtN 6 




SHIFT A 


FCTN 7 


<insert Une> 


SHIFT R 


FCTN 8 


<esc> 


SHIFT Z 


FCTN 9 


{ 




FCtNF 


} 




FCTN G 


I 




FCTN R 


] 




FCTN T 


<left-arrow> or 


SHIFT S 


FCTN S 


<back8pace> 






<rigN:fc*arrow> 


SHIFT D 


FCTN D 


<down^arrow> 


SHIFT X 


FCTN X 


<up-arrow> 


SHIFT E 


FCTN E 


<return> 


ENTER 


ENTER 


<quit> 


sHjrr Q 


FCTNa 



Action 

Deletes a charact^' in thtf Ei^tc^. 
Inserts a character in the Editor, 
Deletes a line from the screen. 
Displays the next 24 lines of the file. 
Moves the display to the next window. 
Oisplays previous 24 lines of the file. 
Moves the cursor to the next tab position. 
Inserts a line. 

Returns to the previously displayed screen. 

In the Editor, enters the command mode, 

Tjfpes the left brace {. 

Tyi^ ^ rigbt (aeaee }. 

T^rpes the left bracket [. 

Types the right bracket ]. 

Moves the cursor to the left one character. 

Moves the cursor to the dghli one charact^. 
Moves the cursor down one line. 

Moves the cursor up one line. 
Tells the computer to accept the 

information that you type. 
Lfltaves the Editar/Assen^ler. 
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This BBCtion describes the selections available with the Editor/Assembler. You start 
the creation of an assembly language program by entering it with the Editor. Then 
you may save it, load it, and edit it again if necessary. When it is ready, you may 
assemble it and then load and run it. 

Tbe aupmt h a flashing marker that appeal^ m the screen to indicate where your 
next keystroke appears. In editing, the cursor may be moved with the cursor 
movement keys described in Section 1 or by some of the choices in the command 
mode of the Editor. 

Before using the Editor/ Assembler, be certain that all hardware is properly attached 
and turned on as described in Section 1, with the Editor/Assembler diskette in Disk 
Drive 1 and the Editor/Assembler module inserted in the console. If you have a 
TI-99/4A, it is advisable to depress the ALPHA LOCK key. 

After you select the module, the Editor/ Assembler title appears at the top of the 
screen, followed by the five options as shown below. 



EDITOR/ ASSEMBLER SELECTION LIST 

+ + + + + + 

I *EDITGR/ASSElvBLER* | 

I PRESS: I 

1 1 TO EDIT I 

I 2 ASSENBLE j 

I 3 LOAD AND RUN | 

I 4 RUN I 

I 5 RUsI PROGRAM FILE I 

I 1981 TEXAS INSTRLNCNTS I 

+ +.....4... ...4. + 



To select an option, press the corresponding number key. At any time you may press 
<e»c> to retimi to the previous screen or <quit> to return to the master title serein* 
The five Editor/Assembler options are discussed in the following sections. 
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2.1 EDUOR 

The Editor allows you to load a previously existing file, to create or edit a file, to 
save a file that you have created or edited, to print a file, or to purge a file from 
the computer^B memory. If you press 1 for EDIT, you enter the Editor mode and the 
computer displays the foliovdng selection list. 



Emm m^CTICiN LIST 



* EDITCR * 




PRESS: 




1 TO LOAD 




2 EDIT 




3 SAVE 




4 PRINT 




5 PURGE 





5^»c£ LOAD to load an existing file into the computes memory; EDIT to edit the 
fU^ In memory; SAVE to save a file from mem^yj PRINT to print a file from the 
diskette; or PURGE to delete the file In memoi'y. 

Zmtml Load 

A file on a diskette may be loaded for editing or printing. Any file stored in a fixed 
80 display format or a variable BO display format is accepted by the Loader. By 
saving your files in one of these formats, you may edit a list file or an object file, as 
well as 6 sduroa fUi. Howiivari a ^m|»^88ed objoct file cannot be edited since it 
contains undisplayabie characters. 
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Press I from the Editor selection list to load an existing file. If the Editor has not 
fl^r#ete^ bmn im^f tfift message 

ONE MOMENT PLEASE.« 
is displayed on the screen briefly. Then the prompt 

FILE NAME? 
appears below the selectlcm 

If you have a single disk drive, remove the Editor/Assembler diskette and replace it 
with the diskette that eonta&» the fliA. Wmn two or #ipee jjrives, place the 
pro^m diskette in Disk Drlim 1 ot X Type &m loeatei end name ef ^ f lie which 
you wish to edit, save, or print (such as DSKI.OLDFILE:) and press <return>. (You 
may use the Disk Manager module to obtain a catalog of the files on your diskettes.) 
The file is located and loaded into memory. The Editor selection list is then 
displayed and you may select another option. Notei Each time a file is loaded, the 
previous fiie is removed from memory. 

2.1.2 Edit 

The Edit option loads the Editor from to Edte/Aeaemhier diskette. The Edited 
alloews ymj to create a ^^im m to mM a fUe whleli btm loe^ Wii^ tile Limd 
option. When you enter tlie Editor by pressing 2 from the Editor seiection U^, the 
message 

dNE MOMENT FUEA^„ 

is briefly displayed on the screen while the Editor is loaded from the 
Editor/Assembler diskette. (If the Editor has already been loaded, this message does 
not appear.) If no file has been loaded, the Edit option clears the screen so that you 
may begin a new file. The cursor is positioned in the upper left corner of the screen 
ami is foiiowed by the end-of-file markor i*EOF% Press <retum> to create a new 
line. The Editor is now ready to accept yow new input. 

If a file has been loaded into memory, the Editor displays that file on the screen with 
the €iaaat at iap left, ready for you to edit it. Ym may leave the EditCH- and 
return to the Editor selection list <esc> twice. 
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Note: The file in memory, whether it is a new file or an existing file, may be lost 
if you leave the Editor without saving it. Before returning to the Editor/Assembler 
selection list, be lure to save your program. 

The Editor has feW0 modes: the command mode and the edit mode. You are in the 
edit mode when you first enter the Editor. The command mode is entered from the 
edit mode by pressing the <esc> key. The edit mode is reentered automatically after 
you use a command in the command mode. 

In the iKlit imide^ ttie cia>8or shows where your next k^tMee l» ^NuBiKU In the 

command mode, the cursor is on the second line of the screen ready to accept 
commands. The command that you enter is effective starting from the position the 
cursor had when you entered the command mode. 

. , "St 

2.1*2.1 Edit Moda 

In the edit mode, the screen is 80 columns wide with three overlapping 40 column 
windows available for displaying the text. You start in the left-most window with 
columns 1 through 40 displayed* Pre^^ng <next-windo\^ moves the dlsj^lay to the 
center window, with columns 21 through 60 displayed. Pressing <next-window> again 
moves the display to the right window with columns 41 through 80 displayed. 
Pressing <next-window> at this point returns the display to the left-most window. 

The edit mode allows ypu to create, modl^* and add text to pr@g£|H!Eiff dQldy and text 
files. When you pte^.a^k«^^tha1^.^H^a€ili^ 49 l»le^ on the mmm In thb mmm 

position and the cursor moves one position to the right. (If the cursor is at the right 
margin, it moves to the first position on the next line.) In addition, the edit mode 
has several special keys which perform helpful edit functions. The following table 
describes the special function keys that are t»ed in the Editor^ 

Key Function 

<return> Enters the text into the edit buffer and places the cursor at 

the «^rt ^^ie=*next lin& =^£f <retum> Is pressed at the end 
of the file, a blank line Is automatically inserted^ 

iifwert iine> Inserts a blank iim abQve the line where the c^i^ftor ia 

located. 
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Key Function 

<cielete line> Deletes the current line of text, starting at the location of 

the cursor. 



<in8m-t c1iaracter> Inserts all characters typed until another function or cursor 

movement key is pressed. The following characters on the 
line are moved to the right. The insertion is effective for 
one line only with aU characters after column 80 SmL 

<delete character> DeMffisttthe character utvlent: ^issor. The following 

fl^macters on thQ.Urte itttwi^ ^ the Mt. 



<t9b> 



Moves the cursor right to the next tab location. The tab 
to^tions ffire atst al defaults of 1, 8, 13» 26r31t 46, and 
80* To change the tab locations, use the T(AB command in 
the command mode. If you press <tab> from column .80,. . 
the cursor goes to position 1 on the same line. 



<iiextr-wlndo«tf> 



<roU-up> 



Msvtttf the mmm t^onMiQ right SXm -nm^uwMi^'m) 
you may view cttffwmt pmifons of the text, ''if \yQM ipress 
<next-window> from the right-most window, the left^most 
wliK^w is. ctispiayesU 

Scrolls the screen up by 24-line segments in the edit mode. 
In the command mode, <roll-up> scrolls the screen by 
22-Une segmmits. 



<roll-down> 



Scrolls the screen down by 24-line segments in the edit 
mode. In the command mode, <rolI-down> scrolls the 
screen by 22-line segmeEits. 



<left-arrow> and 
<right-arrow> 



Allow cursor movement to the left or right without 
chmging the text. When the cursor is at the left margin, 
pressing <left-arrow> alternately shows and removes the line 
numbers 



Invokes the command mode when in the edit mode. From 
the command mode, pressing <esc> returns you to the Editor 
selection list. 
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Tl^ ^iSfiHlt line number may be displayed and removed by pressing the <Jef t-arrow> 
key when the cursor is at the left margin. When the line numbers are displayed, the 
last six characters of the 80-column display cannot be viewed. 

2.1.2«2 C0nmmiid Mods 

The command mode, which provides additional editing features, is accessed from the 
edit mode by ^ea^ig <emi>. The emmand mods tis^ the fML tvm Uneft Qf the 
am>een for promptiines and your input, with the remainder of the screen diapisy^ 
your file* If an error is detected, the message ERROR appears in the left-hand 
corner of the second line. Because most of the commands use line numbers, the 
command mode automatically shows the line numbers. The cursor is displayed on the 
second line for command input. 

The command mode promptiine shows the f^lowing prompts on a single line at the 
top of the screen. 

ECDIT,F(IND,R(EPLACE,MCOVE^I(h4SERT,C(OPY,S(HOW,D(ELETE,A(DJUST, 

The commands are selected by pressing the first letter of the desired command. All 
of the edit mode function keys, except <insert-line>, <delete-line>, <up-arrow>, and 
<down-arrow>, are also effective in the command mode. The <esc> key returns you 
to the Editot^ seAttetlif) lidt. 

The effects of all of the commands except MCOVE, KNSERT, C(OPY, and D(ELETE 
start from the position of the cursor when you entered the command mode. The 
commands E(DIT, A(DJU5T, and H(OME occur when you press the letter to choose 
those commands. The other commands require more information, and occur after 
that information is entwed and <return> Is pressed. 

The following gives the command mode prompts, In the order in which they appear in 
the promptiine, and describes their functions. 

E(DIT Returns you to the edit mode, with the display as it was before you 
^eritered the command mode and the cursor at its previous position^ 
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F(1ND 



Enables you to find a string. The promptUne 



FIND <GNT>«COL,C:OU5^)/STRING/ 



appears on the top line of the screen. You may specify an optional count 
number, from 1 through 9999, and optional beginning and ending column 
numbers from 1 through 80. 

The emint mimto speetfios whiiBh oeGioroneie of string is to be found. 
If'fifnitted, the default is 1# ttvo column numbers specify the 

oolumns within which the search is to be made. The column numbers 
must be preceded and followed by parentheses. If the column numbers 
80*0 omitted, the entire line, columns X through 80, is sern'ohed. The 
string must be delimited by elashes (/). The following examples 
demonstrate the use of F(IND« 

Example Result 

/HSLLO/ Findft Itie emju^enee ioP HEU-0» 

1000/iHEU.O/ Finds the 1000th occurrence of HELLO. 

(1,50)/ HELLO/ Finds the first occurrence of HELLO in 



After the string Is located* 1^ E«litor leavfift ccnmnd mode and 
returns to the edit mode. The string is displayed in lino 1 with the 
cursor located on the first character of the string. 



H^EPLMM Reptoi^s ^e given s^ing «4lh a rm/ string. The promptline 



REPLACE<V,><CNT>«COL,eOL»/OLD/NEW/? 

appears at the top of the screen. The count number specifies which 
oceult^ce Qf the mitring ^ be fioimd* If omitted, the default is i. 
The two column numbera ^eelfy the columns within which the swch is 
to be made» the column numbers rraist be prm;eded and fallowed by 



columns 1 through 50. 



X000(X,50)/HELLO/ 



Finds the IGGOth occurrence of HELLO in 
columns X through 30. 



101// 



Finds the 101st space. 
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p^^ttieses. If the column numbers are omitted, the entire line, columns 
1 through 80, is searched. The old string and new string are entered with 
slashes delimiting them. After you press <return>, the replacement 
process begins. 

If V (fta* verify) is ^ecifled, the prompt 

REPLACE STRING (Y/N/A) 

is displayed foUowed by tkB string. To replace that occurrence of the 
atoinci^ ptesB Y. Press N if you 4@ mtt wm^ to r^latse the i^ifsg ^t 
location. The next occurrence of the string is theft Itl^ted (if a count of 
more than one was specified) and the prompt is again presented. To 
replace all subsequent occurrences of the specified string, press A. The 
following demof^Blrate the use of R<|EPLACE. 

Example Result 

1000/HELLO/GOODBYE/ Changes the first 1000 occurrences of HELLO 

to GOODBYE. 

V,20/HE3-LCD — /BYE/ Presents, one at a time, the first 20 

occurrences of HELLO — . You may change 

them to BYE by pressing Y, go on to the next 
one without changing that one by pressing N, 
or change all subsequent ones by pressing A. 

M{OVE Displays the promptline 

MOVE START LINE, STOP LINE, AFTER LINE? 

at tha tc^ of the s^wi. Ttm ^^kio you ent^ specifies the line 
numher of the beginning of the section to be moved. The second value 

specifies the line number of the end of the section to be moved. The 
third value specifies the line after which you want to place the section 
being moved. For example, if you specify 29 as the AFTER LINE, the 
data is moved to line 30. 

A maximum of a four-digit line number may be specified. However, if 
the line number is greater than the EOF marker, the line number defaults 
to the EOF. The EOF line number may be specified by entering E as the 
starting line, stopping line, or after line. Line number 0 indicates the 
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SCHOW 



C(OPY 



KNSERT 



DCELETE 



line above line number 1. When the move is complete, the line numbers 
use of M(OVE. 



Shows the lines starting at the line specified. The promptline 
SHOW LINE? 

appears. You may respond with a line number or E (to see the line at 
the end of the file). For example, if you enter 30, the text on line 
numbflT 50 ivu) ail flUbsequent tmt i« displayed beginning at the mpf of the 
screen. The cursor is located on the first character in line number 3Q. 

Uses the same promptline and functions in the same manner as M(OVE. 
However, C(OPY does not delete lines; it places a copy of the designated 
data at the desired location. 

Allows insertion of a file from a diskette before a specified line number. 
The promptline 

INSERT BEFORE LINE, FILE NAME? 

requires a line number (four-digit maximum) and the name of the file. 
For example, 29,DSK2.0LDFILE inserts the file OLDFILE from the 
diskette in Disk Drive 2 to the file you are editing before line 29. 

Deletes the desired text. The text to be deleted is specified as in the 
M(OVE command. The prompt 

DELETE START LINE, STOP LINE? 

requires the entry of the beginning and ending tine numbeif^ fac the 
deletion. 



Example 
1,51,57 



Result 

Moves line 1 through 51 to a position after line 
57. 



452,E,0 



Moves lines 452 through the end of the file to 
the beginning of the file. 
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Returns you to the ^4 mode. Changes v/frether mtt^» » i^own. 
Thi» aliOWf yitJW ta3 ttftfi tlte tot six columns of text or data. If the cursor 

is located in columns 75 through 80, you must first move it to one of the 
other columns before selecting ACDJUST to leave the line number mode. 

T(AB IMIfies wrd s^ tsba. The Indite has ^fmilt tabs at e^luhnns 1, 1, 1?, 
26, 31, 46, and 80. When ym choose this command, the top Una of 

the screen displays column numbers (123456789 123456789 ...). The 
second line has a T located below each of the columns where tab 
positions are located. Press <space> or <tab> to go to the location where 
a tab Is desired and type T. You may remove by 70|;ilaGiiig a T With 
a ^ace. To adjust tabs in columns t^ l^mi#^i tSt cilflumn mi 
backspace to the position desired. The tab settings return to the defaults 
when the Editor is reloaded. Notes Do not delete the tab at column 80, 

KOME Moves the cursor to the upper left-hand corner of the screen. 



2.1.3 Save 

After you have edited a file, it must be saved on diskette for future use. Otherwise, 
when you leave the Edltt^^ %h0 file may be lost. You m^- a ftle ^ p«#<sln^ 3 from 
the Editor selection list. The prompt 

VARIABLE 80 FORMAT (Y/N)? 

a|3pearS' at the bottom of the screen. If Y is prei»ed« a is opened with a varts^Ie 
80 display foFmat, which uses l^s spaoa on ^ dinette than a tee^ 80 il^lay 
fOTmat. If you press N, a fixed 80 display format is used. After a file lie: saved on 
diskette, its format cannot be changed unless the file is reloaded into memary and 
saved again in the new format. 

After the format is chosen, the prompt 

FILE NAME? 

i» displayed. If you ha^i?© a ^trtgle 'Mi drive, remise Editor/ Assembler ^^ette 
and repl«^ it with the diskette that contaim the ^e» If you have two or three di^ 
drives, place the program diskette In Disk Drive 2 or 3* To save your file on a 



BmrOH/ASSEMmMH 

Pa@e 30 



USING THE EDITOR/ASSEMBl^ 



diskette, enter the device and filename. For example, DSKl.SAVEFILE saves your 
file on the diskette in Disk Drive 1 under the name SAVEFILE. After you save your 
file, be sure ^tat the BMrn/AmmMat diskette is in Dl^ Drive 1. 

You may also save your file to the RS232 by specifying RS232 as the filename. The 
output is then directed to the device connected to the R5232, which is normally a 
printer. When outputting to the RS232, you must specify a file that is in variable 80 

You ma^ Vilish to use the print option to print a file instead of the save option. 
However, outputting is faster with SAVE than with the PRINT option. The TI 
Thermal Printer may not be used with the save option. It is only accessible from the 
print option. 

2.1^ Print 

The print option allows you to print a file to the RS232 Interface, the Thermal 
Printeri or a diskette file. A source, list, object, or any other fUe In either a 
variable 80 dte|>Iay fortnat or a fixed 80 display ferniat can be printed. A printed 
compressed object file may appear somewhat confusing because it contains 
unprintable characters. Select the print option by pressing 4 on the Editor selection 
list. The prompt 

FILE NAME? 

appears on the screen. If you have a single disk drive, remove the Editor/Assembler 
diskette and replace it with the diskette that contains the file. With two or three 
dirie dHves, place the program diskette in Disk Drive 2 or 3. Enter a filename, such 
as [^KJUOLDFILC« The file must be on a diskette^ Aftm you enter the filename, 
the prompt 

DEVICE NAME? 

appears. A diskette file, RS232, or TP may be specified as a device name. If the 
diskette is specified (to ddplii^i^ a 1M the an^e cSaketta ^lemme, such as 

DSKl.PRNTFILE, must be entered. The output file is in variable 80 format, so an 
object file duplicated with the print option cannot be loaded by the Loader. 

After you specify the device, the file is printed on that device. The print option 
does not require that the Editor be in memory. If the Editor is in memory, t^e print 
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option does not alter the %ei^ btiinf m fm ma^ emi^mm io yth 

the print option. 

After you havH printed your file, be sure that the E^^/MMMr ^^Mt^ k bl M 



2.1*5 Purge 

The pmw» (^tto allows you to remove fUff etffiC«ifl^r in smm^ 'fi^ffm pm 
select the purge Option by pmmSiSi% 5 trom the Editor selection list, the prompt 



ARE YOU SURE (Y/N)? 

appears at the bottom of the screen. If you fifess the file is cleared from 
memory and is no longi^ aotiiitttta. If ydu pfsas N, M fHis ferriains In mttMry and 

you are returned to the Editor selection list. You should normally save your file 
prior to purging it from memory. You normally only purge a file when you wish to 
create a new file. 
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2.2 ASSEMBLE 

The Assembler allows you to assemble files that you have created, edited, and saved 
vfUh the Edte, If ym pe9» 2 for ASSEMBLE from the Editcr/Asaembler election 
list, you enter the Assembler^ 

2.2.1 File and Option Specification 

If the Assembler has not been previously loaded, the (KN)in|St 

LOAD ASSEMBLERr? 

appears on the screen. If you press N you are Fe^jrned to Ch^Etlitor/ Assembler 
selection list. If yeu Y, and the Editor/ Assembler diskette is in Disk Drive 1, 
th& Qiessa^e CNE MD^^MT PLEASE... is d^w^asyed and the Assembler Is loaded. If 
the Assembler has already been loaded, the prompt LOAD ASSEMBLER? is omitted* 

After the Assembler is loaded, the prompt 

SOURCE FILE NAME? 

appears. Type the file name, such as DSKl. SOURCE, The source file must be on a 
diskette in either a fixed or variable 80 display format. Then the prompt 

OBJECT FILE NAME? 

appears. Type the object file name, such as DSKl. OBJECT. The object file (which 
is created if it does not already exist) must be on a diskette. It is created by the 
Assembler in a fixed BO format. Then the prompt 

LIST FILE NAME? 

appears. Type the list file name, such as DSKl.LIST. Just press <return> if you do 
not want a listing. The list file can be output to a diskette file or the RS232 
Interface and is always in a variable 80 di^$^ fcvmat. Then n» prompt 

OPTIONS? 

appears. The options available and their functions are listed on the next page. 
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Option Function 

R Defines the Workspace Register symbiiU RO t^ou^ R13 £0 0 

threui|h 15. 

L Specifies list file generation. 

S Specifies that a symbol table dump is to be included in the list file. 

C Specifies that the object file is to be in compressed format to save 

space on the diskette. 



If no option ic desired, simply press <return>. If you want more than one option) 
enter each letter with no commas or spaces between the letters. If L (list file 
generation) is not specified in the option input, the Assembler does not create a 
lining even though a list file name was specified. If a list file ia not specified^ the 
Asseifibkr aasemblss the pro^^m file more qulekly* The R option is almost always 
required to generate proper object code. If a letter other than L, S, C, or R is 
specified^ it is ignored. 

For exatnpl% the following shows the prompts and your responses If yoiU wish tts 
assemb^ a file named SOLMCE, list it to the RS232 at 9600 baud, name the object 
fUe OBJECT, and use the options L, S, and R. 



Prompt Your input 

SOURCE FILE NAME? DSKl.SOURCE 

OBJECT FILE NAME? DSK1.0BJECT 

LIST FILE NAME? RS232.BA=:9600 

OPTIONS? RLS 
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Z.2.Z Aawmbly 

After you enter the options, the program transfers control to the Assembler. While 
the MmMm U running, the message 

ASSEMK-ER E)«CUTI|sJG 

appears at the bottom of the screen. If a fatal error is encountered, the Assembler 
returns the error code and stops assembUng. If a non-fatal error is detected, the 
line number and ^appt^iiaM^ w^sit ifi^nage are dli^fste^ed at the bottom of tiie screen 
ami asaembiy continues. See Seetlon i5 for a complete desCTlption of the Aesembler 
output. 

When assembly is complete, the total number of errors is shown on the screen, as 
well as the message 

PRESS ENTER TO CONTINUE. 

When <return> is pressed, the program returns to the Editor/ Assembler selection list. 
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2-3 LOAD AND RUN 

Y0M may load and run the object code produced by the Assembly pr^isfi^ng 5 te 
LQM) PHt> RUN ftM the Editor/Assembler selection list. When you select LOAD 
AND RUN, the prompt 

FILE NAME? 

appisrar^; If you have a single disk driv6» tmmm iho Editor/ Assembler diskette and 
replace it with the diskette that contains the file. With two or three disk drives, 
place the program diskette in Disk Drive 2 or 3, The file must be an object file on a 
diskette in either regular or compressed object format. Type your filename (such as 
DSKl.OLIDOBj) and j^em ^etMm>* 

After the file is loaded, the filename is erased from the screen and you may enter 
another filename. You may load as many files as you like until the memory is full. 
Note: If an error occurs in loading any file, then all files must be loaded again. 
After you fWave loaded all your files, you may proceed by pressing <return> vi/ithout 
entering a file name. 

The prompt 

PROGRAM NAME? 

appears n^ct. The program nanne is any entry point in your program marked by a 

label which has been defined in the DEF list of the program. If you press <return> 
without entering a program name, the program most recently executed is located and 
executed. 

If the ^»r^am has an entry label with an END statement, the Loader starts 
executing from that label without prompting for the program naitne» If you attempt 
to run a program in vi/hich there are unresolved references, an error occurs. 

Notes Once your program has started to run, it is in total control of the computer. 
Unless the program allows you to return control to the Editor/ Assembler, to TI 
BASIC, or to the master selection list, the only way to stop the program is to turn 
off the computer. 
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2.4 RUN 

You may run a program that has already been loaded into memory by pressing 4 for 
RUN from the Edit or/ Assembler selection list. When you select RUN, the prompt 

PROGRAM NAME? 

appears. The program name is any entry point in your program marked by a label 
which has been defined in the DEF list of the program. If you press <return> without 
entering a program name, the program most recently executed is located and 
executed. 

If the program has an entry label with an END statement, the Loader starts 
executing from that label without prompting for the program name. If you attempt 
to run a program in which there are unresolved references, an error occurs. 

Note: OncN» you^ program h«ff ter Ited to tur^'lt Is in total control of the t^mputer. 
Unless the program allows you to return control to the Editor/Assembler, to TI 
BASIC, or to the master selection list, the only way to stop the program is to turn 
off the computer. 
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2.5 RUN PROGRAM FILE 

You may load and run a file that is on a diskette or cassette as a memory image file 
by pressing 5 for RUN PROGRAM FILE from the E4i&or/^Ma«iiRUeff s^eetloi^' list* 
You may create and save a file as a memory image by using the SAVE utility 
provided on the second Edit or/ Assembler diskette. See Section for a description 
of this utility. 

Some arcade games are ^ovided by Texas Instrunnentft. in this format and may be tm 
using this option. The game on the second Edi1Nli/Al$@l^ler diskette must be put in 
this format with the SAVE utility before you can use it. 

When you choose this option, the prompt 

PROGRAM FILE NAME? 

is displayed. Enter the name of the program preceded by the device name. For 
example, DSKl.GAME is a proper program filename. The program is then loaded and 

nm^ ■ . 

Notes Once your program has started to run, it is in total control of the computer. 
Unless the program allow/s you to return control to the Editor/Assembler, to TI 
BASIC, or to the master selection list, the only way to stop the program is to turn 
0ff ^ computer. 
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This s^tto t« Hoitie C©(t»^MtKp and T^$^m ve^t^B^m^^m 

allow you to use Registers, transfer vectors, Workspaces, source staterriertt fOfJDSfiSf 
expressions, constants, symbols, terms, and character strings. 

3.1 AGISTERS 

A register is a memory word that serves a secific purpose. Registers in Random 
Access Memory (RAM) are called "software" registers. A set of 16 consecutive 
registerfi; Is C&U^ a "workspace." 

Three "hardware" registers are located in the CPU itself. They are the Program 
Counter Register, the Workspace Pointer Register, and the Status Register, 

3*1.1 Program Counter Register (PC) 

The Program Counter Register (PC) keeps track of the location of the next 
instruction in memory. The PC manages the program and maintains a sequential and 
orderly flow of instructions. 

3.1.2 Workspace Pointer Register (WP) 

The Workspace Pointer Register (WP) contains the address of the current software 
workspace. 
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3.1.3 Status Register (STT) 

The Status Register (ST) contains indications of the present status of the computer. 
Each bit of the status register is initialized to zero when ^£^>e@r]ipt|M ^9 tened on. 
TheiH as each instruction Is performed, the computer indtatsft '^-^tfi^ 1^ isNtri^ing 
the appropriate "switches" as a result of that instruction. By this method the bits 
are set (changed to 1) and reset (changed to 0) by machine instructions. Status bits 
have the following meanings. 









Name 


Number 


MeaiiitiiE] 


L> 


0 


Logical greater than 


A> 


1 


Arithmetic greater than 


EQ 


2 


Equal 


C 


3 


Carry 


ov 


4 


Overflow 


OP 


5 


Odd parity 


X 


6 


Extended operation 




7-11 


Reserved 


INT. 


12-15 


Interrupt mask 



MASK 



In the diagrams in this manual, bits that are checked or set have a caret C) printed 
under them. The foUowirig Is a ref^esentation of ^ ^^tus-l^i^^ with the L> and 
EQ bits set. 



Status Register 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
L/.rw|EQ|C lOVlOPlX I INT. MASK | 



The following table indicates the bits in the Status Registw that may be affected by 
the various assembly language Instructions. 
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Status Bits Affected by Instruction?' 



|V| F lc>ITifhH.m 


t 1 > 

i 1 — 


A> 


EG 


c 


ov 


OP X 


A 


V 


X 


X 

/x 


X 


X 

/^x 




AR 


y 


X 


X 


X 


X 


X - 


MD3 


Y 


X 


X 


X 


X 




A t 


V 
A 




V 

/\ 


X 


X 


















o 
D 














m 
dL- 






























y 


X 


X 








PR 


X 


X 


X 






X - 


PI 


X 


X 


X 








PI R 














coc 






X 














X 








DEC 


X 


X 


X 


X 


X 






X 


X 


X 


X 

xx 


X 

^x 




nT\/ 










X 

/x 




IMP 


V 


X 


X 


X 






TMPT 




X 




X 


X 




TMV 

ilN V 


y 


V 


X 




































JH 














OHE 














3L 














OLE 














JLT 














3MP 














JNC 














ONE 














JNG 














JOC 















Mnemonic 


l_> 


A> 


EQ 


c 


OV 


OP 


X 


aop 
















LDCR 


X 


X 


X 


X 


_ 


2 




LI 


X 


X 


X 




_ 






LIMI 
















LWPI 


^ 


^ 








_ 




MOV 


X 


X 


X 





_ 


_ 




MOVB 


X 


X 


X 


_ 




X 


• 


MPY 
















NEG 


X 


X 


X 


X 


X 




_ 


OR I 


X 


X 


X 


_ 


_ 




• 


RTWP 


X 


X 


X 


X 


X 


X 


X 


S 


X 


X 


X 


X 


X 


- 


- 


SB 


X 


X 


X 


X 


X 


X 


- 


SBO 


_ 




. 


- 


• 


- 


- 


SBZ 
















SETO 
















SLA 


X 


X 


X 


X 


X 






soc 


X 


X 


X 










SOCB 


X 


X 


X 


^ 




X 




SRA 


X 


X 


X 


X 




tm' 




SRC 


X 


X 


X 


X 








SfiL 


X 


X 


X 


X 








STCR 


X 


X 


X 




_ 


2 




STST 
















StWP 
















SWPB 
















szc 


X 


X 


X 










SZCB 


X 


X 


X 






X 




TB 






X 










X 


3 


3 


3 


3 


3 


3 


3 


XOP 


3 


3 


3 


3 


3 


3 


3 


XOR 


X 


X 


X 











Notess 

■'"In addition to these instructions, the instructions CKOF, CKON, IDLE, LREX, 
and RSET are included in this manual for completeness. None affect any status 
bits or have any other useful effect on the Home Computer. 

'Whai m UX^ m StCH instruction tr^tfistes eight or fewer bitSy ^ bit is 
aet or reset as in byte instrgctions. Otherwise, the OP bit is not affected. 

■^The X instruction does not affect any status bit. The instruction executed by 
the X instruction sets status bits normally. When an XOP instruction is 
implemented, the XOP bit is set, and the subroutine sets status bits normally. 
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3.1.3.1 Logical Greater Than— (L>) 

The logical greater th^ bit U vihm m iMgped numb^ U comps^ with d 
smaller undgned numbra^* Ip this eoifipaetsoFii the nu^ slgnif^r^ bits of the w^#i 
being compared represent 2 • The least significant bitx of the bytes being compared 
represent 2^, 

3.1.3.2 Arithmetic G^ttgSttr Than— (A» 

The arithmetic greater than bit is set when a signed number is compared with a 
smaller signed number. The most significant bits of the words or bytes being 
compared represent the sign of the number, zero for positive or one for negative. 
For positive numbera, the remairiihg bil^ tepl^sent the binary value. For negative 
numbers, the remaining bits represent the two's complement of the binary value. 

3.1.3.3 Equal— (EQ) 

The equal bit is sdt lA^wn the twdr wcX'dit or b^tem beirig eornpdEed equal. The 

significance of equality is the same whether the comparison is between unsigned 
binary numbers or two's complement numbers. 

3.1.3.4 Carry— (C) 

The carry bit is set by a carry of 1 from the most significant bit (sign bit) of a word 
or byte during arithmetic and shift operations. Thus the carry bit is used by shift 
operations to tfore the last bit ^fted out of the Workspace Register being shifted. 

3.1.3.5 Overflow— (OV) 

The overflow bit is set when the result of an arithmetic operation is too large or too 
small to be te^atesesi^fBd ccn^eetly In trntf^ eon^lement repreientat|iiniE 




In addition operations, the overflow bit is set when the most significant bits of the 
operands are equal and the most significant bit of the result is not equal to the most 
aigniftcant Mb of the destination operand. 
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In subtraction operations, the oversow bit is set when the most significant bits of the 
operands are not equal and the most significant bit of the result is not equal to the 
most significant bit of the destination operand. 

a iS^liiR Ite U se^'w^en mm% wiqn^flcartt H bits W 

the ^vy^d «W« 1^ c».^«t «o ^ tft^wM^v ■ ' - . 

For an arithmetic left shift, the overflow bit is set if the most significant bit of the 
worl<space register being Mffced t^mr^eS; ve^Ue. 

For the absolute value and negate instructions, the overflow bit Is set when the 
source operand Is the maximum negative value O8000). 



3.1.3.6 Odd Parity— (OP) 

In byte operations the odd parity bit is set when the parity of the result is odd and is 
reset when the parity is even. The parity of a byte is odd when the number of bits 
having values of one is odd. When the number of bits having values of one is even, 
the parity of ^ ^yte to even. The odd parity is equal to the least significant bit 
of the sum of the bits in the byte. 



3.1.3.7 Extended Operation— (X) 

The extended iqseratlUon instruction (XOP) is available in some TI-99/4A computers* 

The only way to determine if your computer supports this instruction is to try it. 
Extended operation instructions permit a limited extension of the existing instruction 
set to include additional instructions. In the computer, these additional instructions 
are implemented by software routines. 

When the program contains an XOP instruction (see Section 1A.5) that is softw«Pa 
implemented, the computer locates the XOP Workspace Pointer (WP) and Program 
Counter (PC) words in the XOP reserved memory locations and loads the WP and PC. 
Tfmn £he computer trarmfere control to the XOP instruction set through a context 
switch (See Section X2% When the context switch is completey the XOP w0ii^mM 
contains the calling routine's return data in Woricspacs Registerct 13, 14* and 15. 

The extended operation bit is set when the software implemented extended operation 
is initiated. 
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>.l»3.i Internet Mmk 

The interrupt mask is status bits 12 through 15, Any device with a level number less 

^ m ^» M^m in ir^fiJip itis*; U prnt^^^ toy «Ht TMI^SO 
mimpro0siEg^ £0 li^ttrrupt a running program. Thm If M Interrupt mask has a 
value of 2 (binary 0010), any device with a level of 0, 1, or 2 may interrupt a running 
program. On the TI Home Computer, all intfri:upts are on levej, 2, Thu« veiiis? 
of 0 and 2 are useful. 
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5.2 TRANSFER VECTORS AND WORKSPACE 

A transfer vector is two consecutive words of memory which contain a pair of 
memory addresses. The first word contains the address of a 16-word area of memory 
called a workspace, and the second word contains the address of a subroutine entry 
point. The corrrplut^ uses a transf^ yectm ^ perfOTm a transfer of control called a 
CGPtext switch. 

A context switch places the contents of the first word of a transfer vector in the 
Workspace Pointer Register. The active workspace becomes the workspace addressed 
by t^Mt wmif wi^ Htm IS ^timtli of aMv^ wG^^iapmsB caUed regl^ar^ 0 thrmigh 
15. These are avi^lE^le tor uae m gena^ |:»urF»i8ie r^^titerd) adc^msa registers, or 
index registers. The context switch places the contents of the second word of a 
transfer vector in the Program Counter, causing the instruction at that address to be 
executed next. 
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3,3 SOURCE STATEMENT FORMAT 

An fiosembly language source program consists of source Statements which may 
contaUi assembler directives, machine instMstlons, pseudo-instructionsy or comments. 

Each line Cor record) of a source statement consists of a maximum of 80 characters 
of information (including spaces). A record may be subdivided into several variably 
sized sections known as fields. 

The label field is pod^omd at the beginning of the source sUifeeiMit and serves as a 
reference point. The op-code field is the operation code (a number, name, or 
abbreviation) of the task to be performed by that source statement. The operand 
field stipulates the value that is to be operated upon or manipulated. It may be a 
mislbmf «&indi ad^««iH etc Th^ eocnmant field is an area fttaarvod for ymi to make 
comments that inmme the readabiUfy of the p r o yw iii but that da not affteft the 
operatinns of the computer. The syntax definition describes the required form for 
the use of commands as related to the fields. Section 4 describes formatting 
procedures and definitions in detalL 

The follow^ conventions apply In the syntax definitions for nmchine instructions and 
assembler directives. 

a Items In capital letters, including special characters, must be entered exactly 
as shown. 

e Items within an^ braek^ (<>) are defined by you. 

a Items in lower-case letters represent classes (generic names) of items. 

a Items within brackets ([]) are optional. 

a Items within braces ({ }) are alternative items, one of which must be entered. 

• An ellipsis (...) indicates that the preceding item may be repeated. 

• The symbol b represents one or more blanks or spaces. 

The syntax (required form) for source statements other than comment statements is 

defined as follows. 

[<Mtt»i>£>] b op-code b [<operand>] [,<operand>] .» b t<coiinrfmt>] 

As this syntax definition indicates, a source statement may have a label, which you 
define. One or more blanks separate the label from the op-code. Mnemonic 
operation codes, assembler directive codes, and pseu do- operation codes are all 
included in the generic term op-code, and you may enter any of these. One or more 
blanks ae^ariie the OfHsodft fmm Urn opmnd, when m opmnd Is reqi^edt 
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Additional operands, when required, are separated by commas. One or more blonks 
aeparate ttm operand or oporands from the comment field. 

Note: Although the maximum length of a source record is 80 characters, the list 
file di^^s only the first 60 characters of each line* 



3.3.1 Character Set 

The A&Bemblw recogrUzes the following ASCII characters. 

The alphabet (upper-case letters only except in comment «id text field^ and 

space character 

The numerals 0 through 9 

Several special characters and control characters 
The character set it Usled in the Appendix* 



3.3.2 Label Held 

The label field begins in the first character position of the source record and extends 
to the first blank. The label field consists of a symbol containing up to six 
characters, the first of which must be alphabetic. Additional characters may be any 
alphanumeric characters. A label is optional for machine instructions and for many 
assembler directives. When a» liM is onUtUid^ howttver, the firifc character 
position must contain a blank. 

A source statement consisting of only a label field is a valid statement. It has the 
effect of assigning the current location to the label. This is usually equivalent to 
placing the label in the label neld of the fdOonving m«»Mrtt Uwlrue^DCi or naiiml^ef 
directive. However, when a statement consisting of ifnlfy a label is i^eecedod by a 
TEXT or BYTE directive and is followed by a DATA directive or a machine 
instruction, the label does not have the same value as a label in the following 
statement unless the TEXT or BYTE directive left the location counter on an even 
(word) locaUon. An EWm4 ifire^ive following the TEXT or BYTE directive prevente 
this problem. 
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3.3«3 Operation Field 

The operation (op-code) field begins after the blank that terminates the lab^ fiaki or 
in the ^st non-biank chdrac^ po^^eti after the firA character position when the 
lid>ei is omitted. The opetlAkin field is terminated by one or more blanks and may 
not extend past character position 60 of the source record. The operation field 
contains an op-code, which is one of the following. 

• Mnemonic operation code of a machine instsructlon 

• Assembler directive operation code 

• Symbol assigned to an extended operation hy a DXOP directive 

• Pseudo-instruction operation code 

3.3.4 OpMnd Field 

The operand field begins after the blank that terminates the operation field. It may 
not extend past character position 60 of the source record. The operand field may 
contain one or tmm es^irasBions, terms, or constants, according to &m mqi^^fnenfcs 
of the particular op-code. The operand field is terminated by one or more blanks. 

3.3.3 Comment Field and Comment Line 

The comment field hegins aftw the Uank that terminateB the operand field, and may 

extend to the end of the source record if required. The comment field may contain 
any ASCII character, including blank. The contents of the comment field are listed 
in the source portion of the assembly listing but have no other effect on the 
assembly. 

Conimfit statsmento eon^ of m sin^ field staptiag: wu^feh an asterisk (*) in the first 
character position and followed by any ASCII character, including a blank, in each 
succeeding character position. Comment statements are listed in the source portion 
of the assembly listing, but have no other effect on the assembly. A totally blank 
line is also treated IIS a^ie^Mment' IMto 
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WssimBmiima ate used in aperand fields of asmtMm i^tte^VBs mid ftmMm 
instructions. An expression is a constant or syrr^ol, a series of constants or syiilbol^ 
or a series of constants and symbols separated by arithmetic operators. Each 
constant or symbol may be preceded by a minus sign (unary minus) to indicate a 
negative value. An ex(n*e88lan may contain no embedded blanks or symbols that are 
defined as extended operations. Symbols that are defined as external references tnny 
not be operands of arithmetic operations. An expression may contain more than one 
symbol that is not previously defined. When these symbols are absolute, they may 
also be operands of multiplication or division operations within an expression. The 
Assembler only supports program-relocatable symbols. 



3.4.1 WeU-DeflfMMl Eiqprs^iona 



Some assembler directives (noted in their descriptions) require well-defined 
expressions in the operand flttldaw For an expression to be well-defined, any symbols 
or assen^ly^iima eonstarits in the i^^ession must have bmm pmviwx^ dsfihect 
Also, the evaluation of a well-defined expression must be absolute, and a well'^defined 
expression may not contain a character constant. 



5.4.2 Arithmetic Operstova 



The arithmetic operators In expressions are as follows. 



for addition 
- for subtraction 

* for multiplication 
/ for signed division 



In evaluating an expression, the Assembler first ne^te# any constant or symbol 
preceded by a minus jflgn (tiwy mim^ and than performs lha ulttlmaUc operations 
from left to right. The Assemtte* does not aadgn pracadenaia ta any operation other 
than unary minus. All operations are integer operations. The Assembler truncates 

the fraction in division. 

For example, the e}^re88ion 4+5*2 is evaluated as 18, not 14, and tiie express 
7-1-1/2 'is evaluate4 it$ 4, rot 7. Itotss ParenOieses may not be used to t^ar &m 
order of the evaluation of ei^iressions. 
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3^ CONSTANTS 

Constants are used in expressions. The Assembler recognizes four types of constants: 
decimal integer ponstants, hexadecimal integer constants, character constants, and 
assembly-time constants* 

Decimal Integer Constants 

A decimal integer constant m^lUwt as a string of numerals. The range of v^ues 
of jieoimid Integers Is -32,768 to +65,335. Positive decimal faiteger constants greater 
than 32,767 are considered negative when interpreted as two's-complement values. 
Operands of arithmetic instructions other than multiply and divide are interpreted as 
two's complement numbers, and all comparisons compare numbers both as signed and 
unsigned values. 

The following «re <lecimal condants. 

1000 Constant, equal to 1,000 or >3E8, 
-32768 Constant, equal to -32,768 or >8000. 

3«5«2 Hexadecimal Integer Conefeants 

A hexadecimal integer constant is written as a string of up to four hexadecimal 

nummto pm&m$b6 by a greater ^han (^) sign. He)adeGimal nunn^aJ^ include the 
decimal values 0 through 9 and letters A through F. 

The following are valid hexadecimal constants. 

>F Constant, equal to 15, or >F. 

>37AC Constar^ equal to 14252 or >37AC. 



^TOR/ASSEMBLER 

Page 50 



GENERAL PRQGRAMM-INQ IPTCglMATIQN 



>.>«3 Charactw ComtanU 

A character constant is written as a string of one or two characters enclosed in 
single quotes. To represent a single quote within a character constant, tWQ 
coiwee»i^ve iiiigto ^uolea are neceviary.- 1te cbaraGtera «re res^sented internally as 
ei#tfe^£ ASCII Ghmctersy witti IN»^l^lMing l^<««t to A chwacter constant 

consisting only of two single quotes (no diaracter) is valid. Thii is ^Uli Sfcrlng. 
and is as^gned the value >0000. 

The following are valid character constants. 

'AB' Represented internally as >4142. 
*C' Represented internally as >43. 

•"D* Represented internally as >2744. 



1.5.4 Aaaembljr-Tline Conalanto 

An assembly-time constant is written as an expression in the operand field of an EQU 
directive. (See Section 14.3.) Any symbol in the expression must have been 
previously defined. The vdutt of &m label is determined at assembly time and Is 
considered to be absolute or relocatable according to the relocatabllity of the 
expression^ not according to the relocatabllity of the Location Counter value. 



* 
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3.6 SYMBCNLS 

Symbols may be used in the label field, the operator field, and the operand field. A 



symbol U m iMci^ of i^tafwnnefff e ch»aG£er% (A |Nfdi:#i Z and 0 throu^ 9^ the 
^8t of whif^ moi^ be an alphabetic dtmmttm* and none of which mfiy bt a Wmk, 

When more than six characters are used in a symbol, the Assembler prints all the 
characters but accepts only the first six characters for processing. User-defined 
symbols are valid only during the assembly in which they are defined. 

Symbols used In the label field become symbolic addreasot^ Th^ va associated with 

locations in the program and must not be used in the label field of other statements. 
Mnemonic operation codes and assembler directive names are valid user-defined 
symbols when placed in the label field. 

The DXOP directive defines a symbid to be used in the operator field. Any symbol 
that is used in the operand field must be plaeod In tlie label field of a statement or 
in the operand field of a RE!F directive, except for a symbol in the operand field of a 
DXOP directive or a predefined symbol. 
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3.7 PREDEFINED SYMBOLS 

The predefined symbols are the dollar-sign <tarai^0r ^ and the Vi&tlsaimicm ^bgii^^ 
symbols^ The doUar^gft ehei«8£t«> W used fsa wiammA 0m emrent location v^Wtt 
the program. The 16 Workspace Register symbols «ur& through R15. They m 
undefined unless you choose the R option when you run the Assembler. 

The fc^owing are examples of valid symbols. 

Al Assigned the value of the loctt^dn 9$ wfMt it appears in the label 



OPERATION Truncated to the first six letters and assigned the value of the 
location at which It appears in the label field. 



field. 



$ 



RippffiVinis Mitt current location. 
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7.8 TERMS 

Terms may be used in the operand fields of machine instructions and assembler 
directives. A term is a decimal or hexadecimal constant, an absolute assembly- time 
constant, or aJlM W QlgfiMt^WilUB* 

It 

The following are examples of valid terms. 

12 Has a value of 12 or >C. 

>C Has a value of 12 or >C. 

WR2 Is valid if Work«pacQ Jiogister 2 is defined as having an absolute value. 

If START is a relocatable symbol, the following statement to not Vfidid as a term. 

WR2 EQU START-»4 WR2 is a relocatable value 4 greater than the 

value of START. Not valid as a term but valid 
as a symbol. 
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3.9 CHARACTER STRINGS 

Several assembler directives require character strings in the operand field. A 
Gharact^atntii ift Wl^^ m m string characters enclosed in #Mle& To 
rcifKFesent a quote within B e#iaracter string, two consecutive single quotes are 
necessary. The maximum length of the string is defined by each directive that 
requires a character string. The characters are represented internally as eight-bit 
ASCII characters, the Idft^ng bits set to zeros. 

The following are valid charactw strings. 

•SAMPI-E PROGRAM' Defines a 14-character string 

consisting of SAMPLE 
PROGRAM. 

•PLAN '^C*** Defines an 8-character string 

consisting of PLAN 'C*. 

'OPEKATOR MESSAGE * PRESS START miVTCH Defines a 27-*eh«^et« ^ing 

consisting of ti)e mtpfatalan 
enclosed In atn^ ffu^eiw 
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Thte aocltau^tasi^ties the addressing modMr OiBd in membly language, ^mnfiles of 
4.1 GENERAL ADDRESSING MODES 

A source 0p«rand is the niimbsr* address, string, etc., which is to be manipulated or 

operated upon. A destination operand is the address where the result of the 
performed manipulation is stored. Instructions that specify a general address for a 
source or destination operand may be in one of five addressing modes. These 
addNttikig modee afid:4IMCiliBS «e disouiMad Iti this section* 

The following lists the T-f idM^ v«All%. iMhich indicates the type of addres^ng mode (see 
Section 5), and gives an example for each of the addressing modes. 



Addressing Modes 

Addressing Mode T-field value Example 



Workspace Register 00 5 

WcH>kspace Register Indirect 01 *7 

Symbolic Memory^' ^ 10 @I-ABEL 

Indexed ^^mm ' ^ ^ @LABCL(5) 

Workspace Rei^ster Indirect Auto-Increment 11 *7+ 



Notess 

^The frwCruetion tefftdras an addll^oma word tot each T'-fidM i^^ua Tim 
additional word contains a memory adcfaress. 

four-bit field immediately following the T-field value of 102» called the S 
(for a source operand) or D (for a destination operand) field, is set to zero by the 
Assembler. 

The T-field value of IQ indicates both symbolic and indexed memory addressing 
modes. If the four-bit neld which follows it contains a zero vaitt% it Is a 
symbolic addressing mode. If it is non-zero, it is an indexed addressing mode, 
and the non-zero value is the number of the index registn. Therefor^ 
Workspace Register 0 cannot be used for indexing. 
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Wa^apmm Rm^stOT Addlrasving 

Workspace Register addressing specifies the Workspace Register that contains the 
operand. A VMf^^ee ns^fime tBdi$m» H specified by a value of 0 throii||H 15 
preceded with an ^% For exampli^ -Wlirl^ace Register 8 is ref«Fr«#-t& 

Examples: 

MOV Copies the cNaM^snts of Wari^paee leister 4 into 

Workspace Registw 8. 

COC R15,R10 Compares the bits of Workspace Register 10 that 

correspond to the one bits in Workspace Register 
15 to one* 



Woricspaeo Register Indirect Addrewing 

Workspace Register indirect addressing specifies a Workspace Register that contains 
the address of the operand. An indirect Workspace Register address is preceded by 
an asterisk (*)• 

Examples: 

A «R7,*R2 Aim thB edi^tents of the Wdrd at Wm address in 

Workspace Register 7^ to ^-GOfSIM^ 
at the address in Workspace Register 2 and places 
the sum In the word at the address in Workspace 
Registw 2. 

MOV *R7»R0 Copies tti0 contend of ttm word stt tSm address 

given in Workspace Register 7 into Work^ace 
Registw 0. 
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4.13 Workspace RegMM' InMreet Auto-lncramant AiMtessing 

Workspace Register indirect auto-increment addressing specifies a Workspace Register 
that contains the address of the operand. After the address is obtained from the 
Workspace Register, the Workspace Register iSrill@^«l)led by 1 f Or a byte 
instruction or by 2 for a word inalrueticin. A Wsikspace RegistOT auto-increment 
address Is preceded by an asterisk and followed by a plus sign (+% 



Examples: 

S *R5*,R2 



Subtracts tbe contents of the word at the address 

in Workspace Register 3 from the contents of 
Workspace Register 2, places the result in 
Workspace Register 2, and increments the address 
in Workspace Register 3 by two. 



R5,»R6+ 



Compares ChCj contents of Workspace Register 5 
with the contents of the word at the address in 
Workspace Register 6 and increments the address 
in Workspace Register 6 by two. 



4*1^ Symbolic Memory Addreaaing 



Symbolic memory addressing specifies the memory address that contains the operand. 
A symbolic memory address is preceded by an "at" sign (@). 



Examples: 



(iFIXl,@LIST4 



Subtracts the contents of the word at location 
nxi from the contents of th0 wiffd (A Idottdon 
LIST4 and places the difference in the word at 
locaUon UST4. 



Ra,©STORE 



Compares the contents of Workspace Register 0 
with the contents of the word at location STORE. 



MOV @12,@>7C 



Copies the word at address >O0OC into location 
>D07C. 
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Indexed Memory Addmeing . 



Indexed memcny addressing specifies the memory address that contains the operand. 
The addiNsss is the sum of the contents of a WeH@iipins*i^igMia^ 'm^ a^mboMe 
address^ An indexed memory address is preceded by an "af jftjpi^) and followed by 

a term enclosed in parentheses. The Workspace Register specified by the term 
within the parentheses is the index register. Workspace Register 0 may not be 
specified as an index register. 

Examples: 

A @2(R7),R6 Adds the contents of the word found at the address 

computed by adding 2 to the contents of Workspace 
RegiafeM 7 to the contents WMkspaee F^ng^^mt 6 
and places the mm in Workspace Reglsto* 6. 



MOV R7,i|UST4-6(R5) Copies the contents of Workspace Register 7 into a 

word of memory. The address of the word of 
memory is the sum of the contents of Workspace 
Register 5 and the value of ^fmbol 1-IST4 minus 6« 
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4«Z PHOC^AM COUNfTER RQJ^TIVE ADE^^ING 

Program Counter relative addressing is used only by jump instructions, A Program 
Counter relative address is written as an expression that corresponds to an address at 
a word boundary* The Assembler evaluates the expression and subtracts the sum of 
the current location plus two. One-half of the difference is the value ^seed In the 
object code. This value must be in the range of -128 through +127. When the 
ins^uction is in relocatable code (that is, when the Location Counter is relocatable), 
the relocation type of the evaluated expression must match the relocation type of the 
cmrrent Location Counter. When the instruction is in absolute code, the expression 
muist be absolute. 

JMP THERE Jumps unconditionally to location THERE. 
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4.3 CRU BIT ADDRESSING 

The CRU, or Communications Register Unit, is a command-driven bit-addressable I/O 
interface. An instruction can set, reset, or test any bit in the CRU array or move 
data between the memoFy mu^ CHU data fi^ds. The CKU software t)ase address is 
contained in the 16 bil^ i£f Wiirl^paBii Regl^e^ }^ Pimtn l^ <MU 9&ft^m^ h&m 
address, the processor is able to determine the CRU hardware base address and the 
resulting CRU bit address. 

The CRU bit instructions use a well-defined expression that represents a displacement 
from the addr^ MtB 3 thraugh 14)* The diiqilaisementj in Iho tm^ of 

-128 through +127, is added to the base address in Workspace Register 12. See 
Sections 9 and 24.3 for more information. 

Example: 

SBO 8 Sets CRU bit to one at the CRU address 8 greater 

than the CRU base address. 
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4.3 cms BtT ADDC^SSmS 

The CRU, or Communicationa Register Unit, is a command-driven bit-addressable I/O 
interface. An instruction can set, reset, or test any bit in the CRU array or move 
data between the memory and CRU data fields. The CRU software base address is 
contained in the 16 bits of Workspace Register 12. From the CRU software hm» 
address, the process^ is able to determine the CRU hardware base address and the 
resulting CRU bit address. 

The CRU bit instructions use a well-defined expression that represents a displacement 
from the CRU base address (bits 3 through 14). The displacement, in the range of 
-128 through +127, is added to the base address in Workspace Regliier 12* See 
Sections 9 and 24.3 for more information. 

Example: 

SBO 8 Sats CRU bit to one at the CRU address fi.^e^er 

than the CRU base address. 
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4.4 IMMEDIATE ADDRESSING 

Immediate instructions use the contents pf the word following the instruction word as 
tSm^0^BS^m^ M Wm^ inatFUcUnni^jTlvii InM^cftate value is an es^r^ion, and the 
fiagmmlb^ P^bebb ^ tl|.^ttlB word following the instruction. Immediate 
instructions that require t^.r^^an^ hsive a Workspace Register address preceding 
the immediate value. ^ 

Example: 

L.I RVIOOO Places >10Q0 into WisH^^pace Register % 
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^5 ADDRESSING SUMMARY 

The foUovii^t^ feeble shows the addressing mode required for each instruction of tho 
Assembler instruction set. The first column lists the instruction mnemonic* The 
second and third columns specify the required address, listed below. 

G - General address: 

Wori^pace Regi^^ aMvss 
Indirect Workspace Register address 

Symbolic memory address 
Indexed memory address 

Indirect Workspace Register auto-increment address 
WR - Workspace Register address 
PC - Program counter relative address 

CRU - CRU bit address 
I - Immediate value 

* - The address into which the result is placed when two operands are 
required 



Instruction Addlressing 





First 


Second 




First 


Second 


Mnemonic 


Operand 


Operand 


Mnemonic 


Operand 


Operand 


A 


G 


G* 


LDCR 


G 


Note 1 


AB 


G 


G* 


U 


WR* 


I 


ABS 


G 




LIMI 


I 




AI 


WR* 


I 


l_REX 






ANDI 


WR* 


I 


LWPI 


I 




B 


G 




MOV 


G 


■m 


BL 


G 




MOVB 


G 




BLWP 


G 




MPY 


G 


WR* 


C 


Q 


G 


mjQ 


Q 




CB 


G 


G 


ORI 


WR* 


I 


CI 


WR 


I 


RSET 






CKOF 






RTWP 






CKON 






S 


G 


G* 


CLR 


G 




SB 


G 


G* 


COC 


G 


WR 


SBO 


CRU 




czc 


G 


wa 


SBZ 


CRU 




DEC 


G 




SETO 


G 




DECT 


G 




SLA 


WR* 


Note 2 


DIV 


G 


WR* 


SOC 


G 


G* 


IDLE 






SOCB 


G 


& 


INC 


G 




SRA 


WR* 


Note 2 


INCT 


G 




SRC 


WR* 


Note 2 


INV 


G 




SRL 


WR* 
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First 


Second 




First 


Second 


Mnemonic 


Operand 


Operand 


Mnemonic 


Op^M 




3EQ 


PC 




STCR 


G* 


Noto % 


JGT 


PC 




STST 


WR 






PC 




STWP 


WR 


- 


JHE 


PC 


_ 


SWPB 


G 


- 


JL 


PC 




S2:c 


G 


G* 


3LE 


PC 


- 


SZCB 


G 


G* 


JLT 


PC 




TB 


CRU 


» 


JMP 


PC 




X 


G 




JNC 


PC 




XOP 


G 


Note 3 


JNE 


PC 




XOR 


G 


WR* 


JNO 


PC 










aoc 


PC 










OOP 


PC 











NotesB 

^The second operand is the number of biU to be transferred, from d through 15, 

with 0 meaning 16 bits. 

^The second operand is the shift count, from 0 through 15. 0 indicates that the 
count is in bits 12 through 15 of Workspace Register 0. When the count is 0 and 
bits X2 througfi 35 of Vtorkapact Register 0 equal 0, the count is 16. 
^Ihe second operand specifies the extemtod of^mi^mi ft&m 0 ^^i^ 15. The 
disposition of the result may or may not be in the first opmnd address, as 
determined by you. 
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An assembler iHBtoction occupies one word (16 bits) of memory. Each word is 
divided into appropriately sized bit fields which are arranged in one of nine formats. 
These formats are discussed below and are referred to in the discussions of the 
instructions in the following sections. Vdu rm»t ctei^ly UndePSfWt aijdreMlng moctes, 
as deaoribed in Section 4, before reading this section. 

Each format contains one or more of the following bit fields, 

Op-Code - Machine operation code. 

B - Byte indicator: 1 for byte in8tructiona,-0 ^oc word instructions. 

Id - Type of addressing mode of the destination operand. 

D * Oe^n«l^on operand. 

Ts - Type of ade^essing mode of the source operand. 

S - Source operand. 



DI^ 



- Displacer^<M "^^^ (^gned). 



C 



Count (bit count). 



W 



- Workspace register. 
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5.1 FORMAT I — TWO GENERAL ADDRESS INSTRUCTIONS 

The operand field of Format I instructions contains two general address&a feparat^ 
by a c0iMi.; Tti^ first address is the source address and the second is the 
destination address. The Format I mnemonic operation codes are listed below and 
discussed in subsequent sections. 



A Add words 

AB Add Bytes 

C Compare words 

CB Compare Bytes 

MOV MOVe word 

MO^ MOVe Byte 

S Si^traot w^ds 

SB Subtract Bytes 

SOC Set Ones Corresponding 

SOCB Set Ones Corresponding, Byte 

SZC Set Zeros Corresponding 

SZCB Set Zeros Corresponding, Byte 

Example: 

SUM A @LABEL1,*R7 Adds the eontents of the WOTd at 



Ideation LABELl to the contents of 

the word at the address in 
Workspace Register 7 and places the 
sum in the word at the address in 
Workspace Register ?. SUM Id the 
location of the instruction. 

Format I instructions are assembled as follows. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I OP-COJE:! B I Td i O l Ts l S I 

When either Ts or Td (but not both) equal binary 10, the instruction occupies two 
vto^^ of memory. The second word contains a memory address used with S or D to 
deveteip the effective addressi Vlftieri both Ts and Td equal binary 10, the instruction 
occupies three words of memory. Tfm i^&ond word contains the memory address of 
the source operand, and the third word contmns the memory address of the 
destination operand. 



EDITOR/ ASSEMBLER 



INSTRUCTION FORMATS 



5 J. FORMAT ir — JUMP INSTRUCTI©|!«e 

Format II instructions use Program Counter (PC) relative addresses coded as 
expressions corresponding to instruction locations on word boundaries. The Format 11 
Joitp mnemonic o^Bralten-mides^ below Wa&mm^ ivi eubtms^mt seetion»« 

S#a Section W thd Fia^Mtn H^mU bit I/O instiwii«m% 

Jump if EQual 
Jump if Greater Than 
Jump if toxical HHgh 
Samp If t^U^ or Equal 
Jump if logical Low 
Jump if Low or Equal 
Jump if Less Than 
unconditional JuMP 
Jump if No Cairy 
Jump if Not Equal 
Jump if No Overflow 
Jump On Carry 
Jump if Odd Parity 



JMP BEGIN Jumps unconditionally to the instruction at 

location BEGIN. The address of location BEGIN 
must not b& ^ater than the address of location 
NOW by more than 128 words, nor less than the 
address of location NOW by more than 127 
words. 

Format II instructions are assembled as follows. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I OP-CODE I DISP I 

The signed displacement value is shifted one bit position to the left and added to the 
contents of the Program Counter after the Program Counter has been incremented to 
the address of the following instruction. In other words, it is a displacement in 
words from the Instruction address plus two. 



JEQ 
JGT 
JH 
JHE 
JL 
JLE 
JLT 
JW 
JNC 
JNE 
JNO 
JOC 
JOP 

Examples 

NOW 
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5.2.1 Format II — Bit I/O IiwtrucUorw 



In addition to jump instructions, the CRU bit I/O instructions also follow Format 11. 
The operand field of Format II CRU bit I/O instructions ccmtalns a weU-deflrad 
0)q9re88iQn \Me^ «^i!aliiU^« ^ a OMJ bit address, relative Id Jlia ^Manils of 
Wcnrkspace Register 12. The Format II CRU bit I/O instructions are listed below and 
discussed in subsequent sections. See Section 3.2 for a discussion of the Format II 
jump instructions. 



SBO Set Bit to log^ One 

SBZ Set Bit to logic Zero 

TB Teat Bit 



Example: 

SBO 3 Sets a CRU bit to one. 
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5.3 FORMAT III ~ LOGICAL INSTRUCTIONS 



T(w operand fieU &f Fptme^ M In^^ic^ cmti^^ a ^mma^ m$^0mst Mciii^ ^ ft 
comm& and a Wiifk^i^ Ri^^er adSrewB. The server^ ad^rm ^ &at-9&(mm 
The Workspace Register address is the destination address. The Format III mnemonic 
operation codes are listed below and discussed in subsequent sections. 



COC Compare Ones Corresponding 
CZC Comjm&'^eros Corresponding 
XOR exclusive OR 



Example: 

COMP XOR liLAK:L8€R5XR5 



Performs an exclusive OR operation 
on the contmito of a memory word 

and the contents of Workspace 
Register 5 and places the result in 
Workspace Register 5. The address 
of the rnemOTy word is the lium of 
the contents of Watka^mm Ragister 
3 and the value of the symlsol 
LABELS. 



Format III instructions are assembled as follows. 



10 11 12 13 14 15 



OP -CODE 



D 



Ts 



When Ts equals binary 10, the instruction occupies two words of memory* The 
second word contains the memory address of the source operand. 
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5^ FORMAT IV — CRU MULTI-BIT INSTRUCTKlhS 

The operand field of Format IV instructions contains a general address followed by a 
&§fm^ mvi'm:m^UiiiMfi^i:s^^ ^ The ^n^al atldre^ is the memoi^y acfdre^ 

wlfieh'^ Mo^tfl^^ iii^ The 'CBy^^^^i^ I@f theJsiMisf^ is 

the contents of bits 3 through 14 of Workspace Register 12. The well-defined 
expression is the number of bits to be transferred and must have a value of 0 through 
15. A 0 value specifies a 16 bit transfer. For eight or fewer bits the general 
address Is m byte address. For nine or m(»;e^te #ia gen^sl address is a word 
address. The Format IV mnemonic operation codes are listed bel^w and discussed in 
subsequent sections. 

LDCR LoaD CRU 

STCR STweCRU - , 

LDCR *R6+,8 Places eight bits from the byte of memory at the address in 

Workspace Register 6 into eight consecutive CRU lines and 
{moments Workspace Register 6 by I. 

r 

Format IV Instructions are as»nhbled as follows. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I OP'CCDE 1 C I Ts 1 S I 

When Ts equals binary 10, the instruction occupies two words of memory. The 
second word contains the memory address for the source operand. 
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5^ FORMAT V — REGISTER SHIFT INSTRlKITICMsK 



The operand field of Format V instructions contains a Workspace Register address 
followed by a comma and a well-defined expression. The contents of the Workspace 
Register are shifted a number of bit positions specified by Uie weE*^fimd 
expresrion* When the t&m equals zero, the shift count must be placed in bits X2-I5 
of WOTkspace Register 0* The Forrmt V mnemonic operation codes are listed below 
and discussed In subsequent sections. 

SLA Shift Left Arithmetic 



SRA 
SRC 
SRL 



ihtft Right Ari^smA 
Shift FUght OfcPBulte 
Shift Right Logical 



Example: 



SLA 



R6,4 



Shifts the contents of Workspace R^^bI^ 6 to the left 4 bit 
positions and replaces the vacated bits with zeros. 



Format V instructions are assembled as follows. 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
CP'CCDE I "5 i W 
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FORMAT VI — SJNQLC Aixm^ immucTimis 

The operand field of Format VI instructions contma a general adtfress. The Fornnat 
VI mnemonic op^Me^ m^^im Us^^^mii'Ms^imt^ ^ «uN«c|yent secUor^ 

ABSoIute. v^je c . . v ■ ■ 

Branch ; ^ . 

Branch and Link 

Branch and Load Workspace Pointer 
CLeaR 

DECrement . . < :■%,<■:- 

DECrement by Two 
INCrement 
INCrement by Two 
INVert 

SEt To One . 
SWaP Bytes 
eXecute 



INC R7 Adds one to the contents of Workspace Register 

7 and places the sum in Workspace Register 7. 
CNT ia the location into which the instruction is 
placed. 

Format VI instructions are assembled as follows. 

0 1 2 3 4 5 6 7 8 9 ID 11 12 13 14 15 
I OP-CODE I Ts I S I 

When Ts equals binary 10, the induction occupies two words of memory. The 
second word contains the memory address of the source operand. 



ABS 

B 

BL 

BLWP 
CUR 
DEC 

DECT 
INC 
INCT 
INV 
NEG 
3ETO 
SWPB 
X 

Example: 

CNT 
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5.7 FORMAT VII — CONTROL INSTRUCTIONS 

Formiife VII instructions require no operand field. The Format VII mnemonic 
operaUon codes are IM^'iMw ^^^RSt^ed' bi- actions. AU but tba 
last instruction have no effect on the TI Home C^omiRfW^ 

ClocK OFf 
ClocK ON 
IDLE 

Lo«^ cr REstart eXecution 
ReSET 

ReTurn with Workspace Pointer 



Returns control to the calling program and restores the context of the 
calling program by placing the contents of Workspace Registers 13, 14, 
and 15 into the Workspace Pointer Register, the Program Counter, and 
the Status Register. 

Format VII i1!)8^UG^on»'4^ife»eiBble# afi'fdUtiWs; 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I op-oax: I Q| Q| 0101 oi 

The op-code field contains 11 bits that define the machine operation. The five least 
significant bits are zeros. 



CKOF 
CKON 

LREX 
RSET 
RTWP 

Examples 

RTWP 
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5.8 FORMAT VIII — IMMEDIATE INSTRUCTIONS 





Th0 



Held of Format VIII iitjilnii^llQrif mf$%Mm^ 
% t 6£trma and an e^tpresslon. The Wdrl@dpi£tt£e f^i^i^ ^ £t» destination 

address, and the expression is the immediate operand. The Format VIII mnemcnlc 
operation codes are listed below and discussed in subsequent sections. 



Al Atld imm^a!^ 

AMM AND Imme<fia^ 

CI Compare Immediate 

LI Load Immediate 

, ORI OR Immediate 

There ere two additional Format VIII instructions that recfite iM)r Hn m^ession in 
the operand field. The expression is the immediate operand. The destination is 
implied in the name of the instruction. These instructions are llstad here. 

LIMI Load Interupt Mask Immediate 
LWPI Load Worl^^KEiiee f%inbi^ tmttmi^lss 



Another modification of Format VIII requires only a Workspace Register SrI^^ss in 
the operand field. The Workspace Register address is the destination. The source is 
implied in the name of the instruction. The following mnemonic operation codes use 
this modified Format VIII. 



STST ST ore STatus 

STWP ST ore Workspace Pointer 



Examples: 



ANDI 4,>000F Performs an AND operation on the contents of Wofk^ace 

Register 4 and immediate operand >0O0F. 

LWPI WRKl Places the address defined for the symbol WRKl into the 

Workspace Pointer Register. 

STWP R4 Places the contents of the Workspece Pointer Register into 

Workspace Register 4. 
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Format VlII inBtruc»Jtma a^mbl^af'^isfi^^'s^ . ' 

0123456789 10 il 12 13 14 15 



OP -CODE 



0 



W 



A zero bit separates the two fields. The instructions that have no Workspace 
Register operand placi^^# In the W field. The instructions #»8t-I^Ve immediate 

Ue,, these ifistt-ueffeS^ Qteif^ words each. 
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5.9 FORMAT IX — EXTENDED OPERATION INSTRUCTION 

The extended operation ihstructte e*wi be used on some Tl Hom C^Kt^utem See 
Section 7,19 fear more information. 

The operand field of the Format IX extended operation instruction contains a general 
address and a well-defined expression. The general address is the address of the 
operand fm the extm^^M operation. TN^-K^^ tlie extended operation to be 

perfornn^ and rmist be foi ^ rwige of 0 l^bugN 15. Tbe Fornix tX mnemonic 
operation code is listed and discussed in subsequent sections. See Section 5.9.1 

for a discussion of the Format IX multiply and divide instructions. 

XOP extended Operation 

Example: 

XOP ©LABEL(R4),12 Performs extended operation 12 using the 

address computed by adding the value of symbol 
LABEL to the contents of Workspace Register 4. 

Format IX instructions are assembled as follows. 

012345678 910 11 12 15 14 15 
I OP-CCPE I D I Ts I S I 

When Ts equals binary 10, the Instruction occupies two words of memory. Tbe 
second WOTd contains the memory address for the source operand. 
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5.9.1 rormat IX ^ Muiti|ily and DMds Im^ruc^ong 

The operand field of Format IX multiply and divide instructions contains a general 
address followed by a comma and a Workspace Register address. The general address 
Is ^ mdxiimBt of the mul^^te or divim, and the Wcn^space Registw address is the 
i^^i^ of tim Warkl^ce Register that contains the multiplicand or diviiisnd.' The 
Workspace Register address Is also the address of the first of two Workspace 
Registers to contain the result. The Format IX multiply and divide instructions are 
listed below and discussed in subsequent sections. See Section 5.9 for a discussion of 
the Format IX c^Kt^nded -operation induction. 

MPY MultiPlY 
DIV Divide 

MPY @ACC,R9 Multiplies the contents of Workspace Register 9 

by the contents of the word at location ACC 
and places the product in Workspace Registers 9 
and 10, with the 16 least significant bits of the 
product in Workspace F^ktar Ilk 

Multiply and divide instructions are assembled in the same format as shown In Soctlon 
5.9, except that the O field contains the Workspace Register operand. 
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The following arithmetic i^istructions are described in this section. 



Instruction Mnemonic Section 



Add ^1^9 






A^ BffSem. 


. - 




ABSolute value 


ABS 


6.3 


Add Immediate 


Al 


6.4 


DECrement 


DEC 


6*5 


DECrement by Two 


DECT 


6.6 


Divide 


DIV 


6.7 


INCrement 


INC 


6.8 


INCrement by Two 


INCT 


6.9 


MultiPlY 


MPY 


6.10 


NEGate 


NEC 


6.11 


Subtract miltds 


s 


6.12 


Subl^act Byte« 


SB 


6.13 



Examples are given in Section 6.14. 

^#eh,in»^iie£lcm c^tn^^^ ofc^^ following Inforr^tioiv 

• A heading, consisting of the instruction name and mnemonic name 

• The op-code 

• The syntax definition 

s Ax% 0%mr^9 of the instruction 

9 Tfm ttofintl^qn of the fristruction 

• The status bits affected 
■ The execution results 

e Application notes when appropriate 

The op-code is a four-digit hexadecimal number which corresponds to an instruction 
word whose address fields contain zeros. 



EDITOR/ASSETMBLEil 

Page 78 



The syntax definition follows the conventions described in Section 5* The generic 
names used in the syntax definitions are: 



gas Qen«^ Address of the Sas^^ opmmi^ 

gad General Address of the Destination operand 

wa Workspace register Address 

iop Immediate Operand 

wad Workspace register Address De&ttrmtitm 

cMsp Displacement of CRU lines from the CRU base regist^ 

exp Expression that represents an instruction location 

cnt Count of bits for CRU transfer 

sent Shift Count 

xop number of extended OPeration 



Source statements that contain machine instructions can use the label field, the 
operation field, the operand field, and the comment field. 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Asa^inbler advances to the location of a word bounds (even 
address) before assembling a machine instruction. 

The operation (op-code) field contains the mnemonic operation code of the 
instruction. The contents of the operand field are defined for each instruction. 

Inclusion of comment ^isld Is optional. If used, it may contain any ASCII 
characters, including blanks. The comment has no effect on the assembly process 
other than being printed in the listing. 

In the execution results, the following conventions are used. 

( ) Indicates "the contents of." 

=> Indicates "replaces." 

* * Indicates "the absolute value of." 



The generic names used in the syntax definitions are also used in the execution 
results. 
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6a ADD WORDS— A 



Op«0iidl^ WOO (Format I) 
Syntax definition: 

[<iabei>] b A b <gas>,<gad> b [<comnnent>] 
Examples 

LABEL A ®ADRl(R2),iiADR2(R3) Adds the word at the address found 

by adding ADRl to the contents of 
Workspace Register 2 to the word at 
the address found by adding ADR2 
to the contend tFf W^i^me 
Register 3 and puts the result in the 
word at the second address. 

Definition: 

Adds a {»3py ot ttm source operaiKl {^mdO to the destination operand (word) and 
replaces the destination operand with the sum. The connputer compares the sum 
to zero and sets/resets the status bits to indicate the result of the comparison. 
When there is a carry of bit zero, the carry status bit is set. When there is an 
ovdr^i»v« Ihs overflow status bit is set. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, carry, and ovwflow. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l L>iA>IEQIC iOVIQPIX !---- I INT. M<VSK I 

'k 'AMA 'A .1 I.... 

Ex^eu^dii reeullss 

(gas) + (gad) => (gad) 
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Application notes: 

The A instruction adds both signed and unsigned integer words. For example, if 
the address labeled TABLE contains >3124 and Workspace Register 5 contains >8, 
Uie instructed 

A 5,@TABLE 

results in the contents of TABLE changing to >312C and the contents of 
Workspace Register 5 mt changing. The logical snd sMmetic greater $^m^ - 
status bits are set and the equal, carryr and overflow status bits are reset. 
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6.2 ADD BYTES— AB 
Op-codes SC®0 (Format I) 
Syntax definition: 

[<iabel>] b AB b <gas>,<gad> b [<comment>] 
Example: 

LABEL AB 3,2 Adds the left byte of Workspace Register 3 to 

the left byte in Workspace Register 2 and places 
1^ rascil^ in the ief t byte of Woric«pac% F%egls^«r 
2, 

Definition: 

Adds a copy of the source operand (byte) to the destination operand (byte) and 
replace th^ diidtihatioti openemd tfm mm* Whoi the doMrce d» iMtinatfan 
op^and is addressed in the Workspace Register mode, onty thtt leftmost byte (bits 
0 through 7) of the addressed Workspace Register is used. The computer 
compares the sum to zero and sets/resets the status bits to indicate the results of 
the comparison. When there is a carry of the most significant bit of the byte, 
the carry status bit is set. When there is an overflow, the overflow status bit is 
set. The odd p^ty bit is set when the bits in the sum (destination operand) 
establish odd parity and is reset when the bits in the sum establish even parity. 

Status bits affected: 

Logical greater thein, arithmetic greater than, equal, carry, overflow, and odd 
parity. 

0123456789 10 11 12 13 14 15 
| L>|A>|EQ[C IQVIQPIX 1 I INT. rvVVSK I 

Execution results: 

(gas) + (gad) => (gad) 
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Application notes: 

The AB instruction is used to add signed or unsigned integer bytes. Fat example, 
If Worksfmce R^sltet 3 contains >7400, memory word >2122 t^nteiiniS >F3ie.:^ 
Workspace Register 2 contains >2123, the instruction 

AB 3,*2+ 

changes the contents of memory word >2122 to >F38C because >74 (the value in 
Workspace Register 3) plus >23 (the value in memory byte >2123) is >8C« The 
left byte of memory word >2122 is unchanged. The contents of Workspace 
Register 2 are changed to >2124, while the contents of Workspace Register 3 
remain unchanged. The logical greater than, overflow, and odd parity status bits 
are set, while the arithmetic greater than, equal, and carry status bits are reset. 
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£.5 ABSCH-UTE VALUEr^BS 



Op-code: 0740 (Format IV.) 



Syntax definltiom 



[<iabel>] b ABS b <ga8> b [<comment>] 
Example: 

LABEL. ABS *2 Replaces the contents of the word starting at 

the address in Workspace Register 2 with its 
absolute value. 



Definition: 

Computes the c^isolutii vito» Cif the mxem f^nmid and replaces the source 
operand with the result. The absolute value is the two's complement of the 
source operand when the sign bit (bit zero) is equal to one. When the sign bit is 
equal to zero, the source operand is unchanged. The computer compares the 
original source operand to zero and sets/resets the status bits to indicate the 
results of the comparison* 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, and overflow. 



0 



| L>IA>|EQ1C IQVIGPIX I 

AAA A 

Execution results: 
*(ga8)* => (gas) 



7 8 9 la 11 12 13 14 15 



INT, MfiiSK I 



Application notes: 

The ABS ins^uetlon la t»ful for tdklng the absolato vfiue of an operand. Par 

example, if the third word in array LIST contains the value >FF3C and Workspace 
Register 7 contains the value >4* the instruction 

ABS iLIST(7) 



changes the contents of the third word in array LIST tot >CX)C4- The logical 
greater Uian staUis bit is set* while the arithmetic greater than and equal status 
bits are reset. 
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6,4 ADD IMMEDIATE— AI 

Op-code: 0220 (Format III) 
Syntax definition: 

[<iabel>] b AI b <wa>,<iop> b [<comment>] 
Example: 

LABEL AI 2,7 Adds 7 to the contents of Workspace Register 2, 

Definition: 

Adds a 60^ of IKe Imtnedlate op^and C^He contents of the word following the 
instruction word in memory) to the eontente of the Woi^eapace Register specified 
in the wa field and replaces the contents of the Workspace Register with the 
results. The computer compares the sum to zero and sets/resets the status bits 
to indicate the result of the comparison. When there is a carry of bit zero, the 
carry status Mt is set. When there is an overflow, ths overflow status bit Is set. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, carry, and overflow. 

0 1 2 3 4 5 6 7 a 9 10 XI 12 13 14 15 
| L>|A>|EQ|C iQVlOPlX I---- I INT. M^K I 

A A A M Mi 

Execution results: 
(wo) + iop => (wa) 

Application notes: 

The AI instruction adds an immediate value to the contents of a Worki^s^tDe 
Register. For example, if Workspace Register 6 contains a zero, the Instruction 

AI 6,>C 

changes the contents of Workspace Register 6 to >OGOC. The logical greater 
than and arithmetic greatffip tart ^tus bits are 80%, while the e^i^y^ and 

overflow status bits are reset. 
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6.5 DECREMENT—DEC 

Op-code: 0600 (Format IV) 

Syntax definition: 

[<label>] b DEC b <ga8> b [<comments>] 
Exannplei 

LABEL DEC 2 Decrements the contents of Workspace Register 

2 by 1. 

Definition: ■ 

Subtracts a value of one from the source operand and replaces the source operand 
with the result. The computer compares the result to zero and sets/resets the 
status bits to indicate the result of the comparison. When there is a carry of bit 
zero, the carry status bit is set. When there is an overflow, the overflow status 
bit is set. 

Status bits affected: 

Logical greats than, srithnnetic ^eater than, equal, carry, and overflow. 

G 1 2 3 4 3 6 7 8 9 10 11 IJ 14 15 

l L>lA>l£QtC iOVlOPiX i— I INT. mSK \ 

Execution results: 
(gas) - 1 => (gas) 

Application notes: 

The DEC instruction subtracts a value of one from any addressable operand. The 
DE© M^Ni&ttort ift ato utt^na in ^^kinting and Mextng byte arrays- Fttr «9ieei^ple, 
if COUNT contains a value of >1, the instruction 

DEC ©COUNT 

results in a value of zero in location COUNT and sets the equal and carry status 
bits while resetting the logical greater ^lan, arithmetic greater tharij wn& 
overflow status bits. The carry bit is always set except on transition from zero 
to minus or^. 
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6.6 DECREMENT BY TWO~DECT 
Op-code: 0640 (Format IV) 
Synt^ definitions: 

[<label>] b DECT b <gas> b [<comment>] 
Example: 

LABEL DECT (3ADDR Decrements the contents of ADDR by 2. 
DefiniUom 

Subtracis two from the source operand and replaots source operand with the 
result. The computer compares the result to zero and sets/resets the status bits 
to indicate the result of the comparison. When there is a carry of bit zero, the 
carry status bit is set. When there is an overflow, the overflow status bit is set. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, carry, and overflow. 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
L>|A>|EQ|C lOVlOPlX I—-- I INT. MftSK I 



Execution results: 
(^s) - 2 => (gas) 



Application notes: 

The DECT instruction is useful in counting and indexing word arrays. Also, the 
DECT instruction enables you to subtract a value of two fr^ any ad^esMl)le 
op^-and. For example, if Workspace Register PRT, which has been equated to 3, 
contains a value of >2C10, the instruction 



DECT PRT 



chsn^ the oortteiftts of Workspace RegietK- 3 to >2C0E« Tim h^md greater 
^Mm» ffi^ithmetlo pNHtt«r tan and carry status bits are set, while the equal and 
overflow status blta are reset. 
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6.7 DIVIDE— DIV 

Op-code: >C00 (Tormat IX) 
Syntax definition: 

[<labei>] b DIV b <gas>,<wad> b [<comment>] 
Example: 

LABEL DIV gADRC2),3 Divides the contents of the words in Workspace 

Register 3 and Workspace Register 4 by the 
value of ADR plus Workspace Register 2 and 
^8ldmtf*1^'l^te^er result in Workspace R^S^ 3 
^^th the remain^ in )AMsi^«M# l^agfateMU 

Definition: 

Divides the destination operand (a consecutive tv^o-word area of workspace) by a 
copy of the source operand (one word), using unsigned integer rtiliMb P^EiidS lln^ 
integer quotient in the first of the two-word denination o^MPfiitd ai^iaiwl liteaa 
the remainder in the second word of U\at same area. Thift Avista ta grttpHically 
represented as follows. 

Destination Operand Workspace Registers: 

Workspace Register (n) iWorkspace Reg i s t er (n+J. ) 
0 15 I 0 15 _ 

< >1< _._> 

Resulting Quotient Resulting Remainder 

Dividend 



Source operand: 

Ad^Be^ftfitb 1 0 r y 

d 15 
< > 

Di V i sor 

The first of the destination operand Wj^o^ai^ Re^^^ itewri 9ktm^ is 
addressed by the contents of the D field. The dividend is right justifi^ in this 
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%rm&t4 omom Wwm diviste k fsompisiey the quotient (result) is placed in tf^ 
first Workspace Register of the destination operand (represented by n) and the 
remainder is placed in the second word of the destination operand (represented by 
n+1). 

When the source dp^and is greats than the first word of the destination 

operand, normal division occurs. If the source operand is less than or equal to 
the first word of the destination operand, normal division results in a quotient 
that cannot be represented in a 16-bit word. In this case, the computer sets the 
overflow status bit, leaves the destination operand unchanged, and cancels the 
division operation. 

If the destination operand is specified as Workspace Register 15, the first word of 
the destination operand is Workspace Register 15 and the second word of the 
destination operand is the word in memory immediately following the workspace 
area. 

Status bits affecteds 
Overflow 

0 1 2 3 4 5 6 7 B 9 10 IX 12 13 14 15 
| L>1A>1EQIC iOVIOPiX i- — -- — -1 INT. Ivy^^i<~l 

A - - - ' - , 

Execi^lcm resLUts: 

(wad and Wdd. +1) divided by (gas) => (wad) and (wad) + 1 

The quotient is placed in wad and the remainder is placed in wad + 1. 

ApplMtion nbtecg 

TUft OiV instrtKtion performs a ^vislorw. Br^ii^f^plei if y^mk^S^m f%^|8|«^ 2 
contains a zero and Workspace Register 3 contains >OOOCy and, the contents: of 
LOG is >0005, the instruction 

DIV @LOC,2 

results in >0002 in Workspace Register 2 and >0002 in Workspace Register 3. 
The overflow status bit is reset. If Workspace Register 2 contained the value 
>0005, the value contained in the destination operand equals 327,692 and division 
by the value 5 results in a quotient of 65,538, which cannot be represented in a 
16-bit word. This attempted division sets the overflow status bit and the 
computer cancels the operation. 
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6.6 INCREMENT— INC 

t^a^mdiBt 0580 O^ormat VI) 
Syntax definition: 

[<label>] b INC b <gas> b [<comment>] 
Example: 

LABEL INC >1A03 Increments the contents of address >1A03 by 1. 

Defirfitiont 

Adda one to the mm^em iopesand and: tepAmmt tta^soureB epmegmd wit^ Ihe result. 
The computer compares the sum to zero and sets/resets the status bits to 
indicate the result of the comparison. When there is a carry of bit zero, the 
carry status bit is set. When there is an overflow, the overflow status bit is set. 

Status Mfcs affected: 

Logical greater than, arithmetic greater than, equal, carry, and overflow. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>1A>IEQIC IOVIC3PIX I I INT. M^K~I 

Exeetition redulta: 
(gas) -I- 1 => (gas) 

Application notes: 

The INC instruction may be used to count and index byte arrays, add a value of 
one to an addressable memory location, or set flags. For example, if COUNT 
contains a zero, the instruction 

INC ICOUNT 

places a >0001 in COUNT and sets the logical greater than and arithmetic greater 
than status bits, while the etfi^ tstttyi find overflow status bits are reset. 
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6.9 INCREMENT BY TWO—INCT 

Op-code: 05CO (Format VI) 
Syntax definition: 

[<label>] b INCT b <gas> b [<comment>] 

LA@EL. INCT 3 Increments the contents of Workspace Register 

' 3 by 2. 

Deflnitiom 

Adds a value of two to the source operand and replaces the source operand with 

the sum. The computer compares the sum to zero and sets/resets the status bit 
to indicate the result of the comparison. When there is a carry of bit zero, the 
carry status bit is set. When there is an overflow, the overflow status bit is set. 

Status bits affected; 

Logical greater than, arithmetic greater than, equal, carry, and ov^flow. 

0 1 2 3 4 5 6 7 6 9 10 II 12 13 14 15 
| L>|A>1EQ|C lOVIOPiX 1* I INT. Mfi^Kl 



Execution results: 
(gas) + 2 => 



Application notes: 

The INCT instruction may be used to count and index word arrays and add the 
value of two to an addressable memory location. For example, if Workspace 
Register 3 cont^ns the address (>2I00) of the fifteenth word of an array, the 
instruction 

INCT 5 

changes Workspace Register 5 to >2102, which points to the sixteenth wop4 of the 
arr^» The logical greater tNor and arithm^tie greater than status bits ste set, 
while the equal, carry, and overflow status bits are reset. 
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6.10 MULTIPLY-MPY 

C^)-code! 38tM) (r^^art: l>0 
Syntax definition! 

[<labei>] b MPY b <gas>,<wad> b [<comment>] 

Example: 

LABEL MPY @ADDR,3 Multiplies the contents of Workspace Register 3 

by the value of ADDR. The result is right 
justified in the 32 bits of Workspace Register 3 
and Workspace Register 4. 

Definition: 

Multiplies the first word in the destination operand (a consecutive 2-word area in 
workspace) by a copy of the source operand and replaces the 2-word destination 
operand with the result. The muItlpUcation operation may be ^aphioally 
represented as follows* 



Destination operand Workspace Registers: 

Workspace Regi8ter(n) iWorkspace Register(n+1) 
0 1510 15 
< > 

Miitiplieand 

< — - > 

Product 



Source operand: 



Addressable Memory 
0 15 

Mul tipl i er 
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The first word of the destination isp^Mmit aNown m the pi^m^sm moot hs 
addressed by the contents of the D field. This word corMne the muItipKcand 
(unsigned value of 16 bits) right-justified in the Workspace Register (represented 
by workspace n above). The 16-bit, unsigned multiplier is located in the source 
operand. When the multiply operation is complete, the product appears 
rl^t^jimtified in the entire 2-word area addressed by the destination field as a 
?2>^Mt unsigned value. The maximum value of either input operand is >FFFF and 
the maximum value of the unsigned product is >FFFE00Q1. 

If the destination operand is specified as Workspace Register 15y the first word of 
the dffi^ina^on ^^ercmd la WoHes^ee Reglete 15 and the second word of the 
destination operand is the memory word immediately following the workspace 
memory area. 



Status bits affected: 
Hone 



0 1 2 3 4 3 6 7 8 9 10 11 12 13 14 15 
| L>|A>|E:Q|C IQVIQPIX I--- — - — --I INT. M^SK~ 1 

Execution results: 

(gas) * (wad) = (wad) and (wad)+l 

The product (32-bit magnitude) is placed in wad and wad + 1, with the most 
aignifloant half in wad* 

Application notes: 

The MPY instruction performs a multiplication. For example, if Workspace 
Register 5 contains >0012, Workspace Register 6 contains >1B31, and memory 
location eontians >0005, the tnstaruction 



MPY @NEW,5 



changes the contents of Workspace Register 5 to >0000 and Workspace Register 6 
to >005A. The source operand is unchanged. The Status Register is not affected 
by this instruction. 
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6.11 mUAm—mG 

op-code: 0500 (Format VI) 
Syntax definition; 

[<label>] b NEG b <gas> b [<eommen^] 
Example: 

LABEL NEG 2 Replaces the cci^itBr^ of Worksp#ef fillister 2 

with its additive^ Invite. 

Definition: * 

Replaces the source opm^and thei two^v^eomf^iriBnt of the aowtse operand. 
The computer determines the two's-complement value by inverting all bits of the 
source operand and adding one to the resulting word. The computer then 
compares the result to zero and sets/resets the status bits to indicate the result 
of the comparison. 

Status bits affected: 

Logical greater than* si^ithmetic greater thanj equaU ond overflow. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>IA>|EQ|C lOVIOPlX I I INT. IVftSK"! 

AAA A 

ExBCutioFi results: 
-(gas) => (gas) 



Application notes: 

The NEG instruction changes the contents of an addressable memory location its 
additive inverse. For example, if Worlcspace Register 5 contains the value >A342, 
the instruction • 

NEG 5 



changes the contents of Workspace Register 5 to >5CBE. The Idgl^ greater 
than and arithmetic greater than status bits are set, while the equal status bit is 
reset. 
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6.12 SUBTRACT WORDS-S 

Op-codes 6000 (Format I) 
Syntax definition: 

[<labBi>i b S b <ga8>y<gad> b [<comfnent>] 
Example: 

LABEL S 2,3 Subtracts the contents of Workspace Register 2 

from the contents of Workspace Register 3. 

Definition: 

Subtracts a copy of the source operand from the destination operand and places 
the differeft^ In the destination t^pmM Ttm GwmpiiSm ctmpmea the difference 
to zmm 6md 9mt»/mtmt9 the status bits to indicsAtw tt^i rssu^ 'of the cornpfaFisctfa* 
When there is a carry of bit zero, the carry status bit is set. When there is an 
oyerfloWk the overflow status bit is set* The source operand remains unchanged. 

Logical greater than, arithmetic greater than, edtial, ^ry, and overflow. 

0 12 3 4 5 6 7 8 9 10 11 12 13 14 13 
| L>|A>|EQ|C IQVIOPIX 1 1 INT, N4^SK I 



Execution results: 

(gad) - (gas) «> (gad) 



Application notes: 

The S instruction subtracts signed integer values. For example, if memory 
location OLDVAL contains a value of >1225 and memory location NEWVAL 
contains a value of >8223, the instruction 



S iiOLDVAL,lNEWVAL 

changes the contents of NEWVAL to >6FFE. The logical greater than, arithmetic 
greater than, carry, and overflow status bits are set, while the equal status bit is 
reset. 
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6.13 SUBTRACT BYTES— SB 

Op-code: 7000 (Format I) 
Syntax definitions 

[<label>] b SB b <ga8>,<gad> b [<comment>] 
Examplet 

LA^U SB • '"^ Subtracts the leftmost byte of Workspace 

Register 2 from the leftmost byte of Workspace 
Register X 

Oeflnitiont ^ . . 

Subtracts a copy of the source operand (byte) from the destination operand (by«te) 
and replaces the destination operand byte with the difference. When the 
destination operand byte is addressed in the Workspace Register mode, only the 
leftmost byte (bits 0^7) in the Workspace Regirtar^ Jiiaed. Tho^Mptte «... 
tstmpae^ the resulting byto to zeto and setsA'ffseits the status bits accordingly. 
When there is a carry of the most significant bit of the byte, the carry status bit 
is set. When there is an overflow, the overflow status bit is set. If the result 
byte establishes odd parity (an odd number of logic one bits in the byte), the odd 
parity status bit is set. ' 

Status bits afftete^ 

Logical greater thani arithmetic greater than^ equalf carry, overfloWy and odd 

parity. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>lA>iEQ|C [OViOPiX 1 1 INT. M^SK~1 

Execution iwtflBi 

<gad> - <ga^ s> <gad> 
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Application notes: 

The SB instruction subtracts signed integer bytes. For exampJe, if Workspace 
Register 6 contains the value >121C, memory location >121C contains the value 
>2331, and Workspace Register 1 contairwl ^ Vil^ >1344, the |fi»WeM*»» 

SB *6+,l 

changes the contents of Workspace Register 6 to >121D and the contents of 
Workspace Register 1 to >F044. The logical greater than status bit is set, while 
the oth^ iltst ft^^^^ed ^'''^Hs' im^nielte i^e reset. 



EDITOR/ASSEMBliER 

Page 97 



ARITHMETIC INSTRUCTIONS 



6-14 INSTRUCTION EXAMPLES 

1 

This section includes several arithmetic instruction examples fm\ farther cl&^i^ealloi). 
The application of these instructions is not necessarily limited to that given. 

6.14.1 Incrementing and Decrementing Examples 

There are two decrement and two increment instructions that may be used for various 
types of control when passing through a loop» indexing throu^ an array, ca* operating 
within a group of instructions. 

The incrementing and decrementing instructions available for use with the Assembler 
are: 

INCrement (INC) 
INCrement by Two (INCT) 
DECrement (DEC) 
dEC^^roent by Two ^CT) 

The single increment and decrement instructions are useful for indexing byte arrays 
and for counting byte operations. The increment by two and decrement by two 
instructions are useful for indexing word arrays and for counting word operations. 
The following sections provide some examples of thdse operations, 

6.14.1.1 Increment Instruction Example 

The example program shows how the INC instruction is useful in byte operations. 
The program searches a character array for a charactOT with odd pasil^* To 
terminate the search, the last chsTEieter oor^iinB The A^oh tioglna at the 

lowest address of the array and maintains an index in a Workspace Register, The 
character array for this example is called Al and is also the relocatable address of 
the array. The code is shown on the next page. 
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SCTO 1 Set counter index to ^1 

^ARCH INC 1 Increment jndex 

MOVB §A1(1),2 Get character 

JOP ODDP Jump if found 

JNE SEARCH Continue aearch if not zero 



ODDP 



SAA^Xwi Decrement Iratnietion E«Miii|te 

To illustrate the use of a DEC instruction in a byte array, this example inverts a 
26-character byte array and places the results in another array of Wb namw size 
called A2. The contents of Al are defined with a data TEXT stateinent as follows. 

Al TEXT 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 

Array A2 is defined with the BSS statement as follows, 

A2 BSS 26 

The sample code for the solution is: 

LI 5,26 Counts and Index for Al. 

LI 4,A2 Address of A2. 

INVRT MOVB @A1-1(5),*4+ Invert array (Note X). 

DEC 5 Reduce counter. 

JGT INVRT Continue if not complete. 



Note: 

@A1(5) addreMet.the elements of array Al in descending order as Workspace 
Register f Is de^Perrar^mL ^ a^^Bsses array A2 in ascending ^der as 
WcrksfmcB Register four is incremented. 
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Array A2 contains the following as a result of executing this sequence of code: 
A2 ZYXWVUTSRQPONMLKaH^GFEDC8A 

Even though the result of this code sequence is trivial, the use of the MOVB 
instruction, with indexing by Workspace Register 5 and the result incrementally 
placed into A2 with the auto- increment function, can be useful in other applications. 

3GT instruction mmd |o termli^ite the loop aIlo\ra Worlcspace Register 5 to serve 
both as a counter and as an index re^ster. 

A special quality of the DEC instruction allows you to simulate a jump greater than 
or equal to zero instruction. Since DEC always seEs the carry status bit except when 
changing from zerfi to inttmofie, H-mn be used in mft^mnE^m wt^ a JOC 
instruction to form a JGE loop. The example belbw performs the same function as 
the preceding example. 



Al 


TEXT 






A2 


BS5 


26 






LI 


5,25 


Counter and Index for Al. 




LI 


4,A2 


Address of A2. 


INVRT 


MOVB 


@A1(5),*4+ 


Invert array. 




DEC 


5 


Reduce counter. 




JOC 


INVRT 


Continue if not complete. 



Note: Since the use of JOC malces the loop execute when the counter is zero, the 
counter Is initialized to 25 rather than 26 as in the preceding example. 
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fi.l4,X.3 Decmment by Two Instruction Example 

To illustrate the use of a DECT instruction in processing word arrays, this example 
adds the elements of a wmd amaay to the eSpmer^ af aru^er word amy places 
the results In the second array. The contents of the two arrays are initialized as 
follows, 

Al DATA 500,300,800,1000»1200,498,65Q,3,27,0 

A2 DATA 36,192,517,29,315,a07,290,40,13O,l>2O 

The sample code that adds the two arrays is as follows. 

LI 4,20 Initialize counter (Note 1), 

SUMS A @Al-2(4),@A2-2(4) Add arrays (Note 2). 

DECT 4 Decrement counter by two. 

JGT SUMS Repeat addition. 

Notes: 

^The counter is preset to 20 which is the number of bytes in the array. 
The addressing of the two arrays through the use of the at sign (@) is indexed by 
the counter, which is decremented after each addition. 

The contents of the A2 array after the addition process are as follows. 

M 536,492,1317,1029,1515,1305,940,43,157,1320 
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ThSW wnother method by which this ^dxiltioin pr&ceaa may be apcompli^ied. This 
method is shown in the following code. 



SUMS 



LI 


4,10 


Initialize counter (Note 1), 


u . 




wl-pqd fi^Qss'of Al (N<c^>^ 


u 


6,A2 


Load address of A2 (Note 2). 


A 


*5+,*6+ 


Add arrays (Note 3). 


DEC 


4 


Decrement counter. 


JGT 


SUMS 


Repeat addition (Note 4). 



^The counter is preset to 10 (the number of elements in the array). 

^This address is incremented each time an addition tak.QS place. The increment 

is via the auto-increment function (+). 

^The * indicates that the contents of £he register are be tided ms en address, 
and the -i- indica|pe« that it is to be automatically incremented by two each time 

the instruction is executed. 

^Workspace Register 4 is only greater than zero for ten executions of the DEC 
instruction, so control is transferred to SUMS nine times after the initial 
execution. • .i 

After execution, the contents of array A2 are the same for this method as for the 
first. 



6.14.2 General Example 

The following program illustrates several of the arithmetic instructions. The program 
consists of a calling program and a subroutine. The subroutine produces the result of 
the function X-(l3*Y|+5) where X and Y are variable data, treated as signed integers, 
and phrased to the subroutine frem the calling profi^m. 
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To simplify the example, no error checking is included in the subroutine, and it is 
assumed that the product of 3*Y is in the range of a signed 16-bit word (-52,768 
through 32,767). 

•CALLING PROCa=lAM 



VAR 



BL 

DATA 
DATA 
MOV 



@CALC 

37 

1804 

0,RESULT 



Call subroutine. 

X value. 
Y value. 
Save result. 



RESULT BSS 



MOV 




Put X value In Regls^ 0. 


MOV 




Put Y value in Register 1. 


ABS 


1 


Take absolute value of Y. 


MPY 


©THREE,! 


Take 3 times absolute value of Y. 


AI 


2,5 


Add 5 to previous refll^t. 


S 


2,0 


Subtract previous result from X. 


RT 




Return. 


DATA 


3 


Constant. 
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The foUwtng Jump and brwich inslruellom are descrifeed in this section. 



Instruction 


Mnemonic 


Section 


Branch 


B 


7.1 


Branch and Link 


BL 


7.2 


Branch and Load Win^^4(»ace Pointer 




7^ 


Obimp if Etea 




7.4 


Jump if Greater Than 


JGT 


7.5 


Jump if High or Equal 


JHE 


7.6 


Jump if logical High 


JH 


7,7 


Jump if logical Low 


JL 


7*8 


Jumt^ if Um ctr Equal 


JLE 


7*9 


Jump If Less Than 


JLT 


7.10 


Unconditional JuMP 


JMP 


7.11 


Jump if No Carry 


JNC 


7.12 


Jump if Not Equal 


3NE 


7.13 


Jump if No Overflow 


JNO 


7.14 


Jump if Odd Paril^ 


JOP 


7.15 


Jump On Carry 


JOG 


7.16 


ReTurn Workspace Pointer 


RTWP 


7.17 


EXecute 


X 


7.18 


Extended OPe^iat^^n 


XOP 

' (. 


7il9 



Exannples are given in Section 7.20. 

Branch Jmteuctions transfer control either unconditionally or conditionally according 
t0 Itie 9tata of one ot mcme bits of the Status Register. The conditional branch 
(jump) inaCructions and the status bit or bits teated are shown on the next page. 
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Status Bits Tested by Jump Instructions 



Mnemonic 


L> 


A> 


EQ 




ov 


OP 


Jump if: 


JH 


X 


- 


X 


- 


- 


— 


L>sl and 


JL 


X 


- 


X 


- 


- 


— 


L>=0 and EQ=0 


JHE 


X 


- 


X 


- 


- 


- 


L>=1 or EQ=1 


JLE 


X 


- 


X 


- 


- 


- 


L>=0 or EQ=1 


OGT* 




X 










A>=1 






X 


X 








A>^0 and EQ=0 


JEQ 






X 








EQ=I 


JNE 






X 








EQ=0 


JOC 








X 






C=l 


JNC 








X 






0=0 


JNO 










X 




OV=0 


JOP 












X 


OP=l 



"""Only JGT and JUT use signed arithmetic comparisons. The others are unsigned 

(logical) comparisons. 



For all jump instructions, a displacement of zero results in execution of the next 
instruction in sequence. A displacement of -1 results in execution of the same 
instruction (a single-instruction loop). 

Each instruction consists of the following information. 



■ A heading, consisting of the instruction name and mnemonic name 

• The op-code 

a The syntax definition 

■ An example of the instruction 

• The de0nltion of the instruction 

• The status bits affected 

• The execution results 

• Application notes when appropriate 



The op-code Is a four-digit hexadecimal number which corresponds to an instruction 
word whose address fields contain zeros. 
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The syntax definition follows the conventions described in Section 5. The generic 
names used in the syntax definitions are: 

Bemt^ii AddriHis tif the Source opemffA 

gad General Address of tiie Destination operand 

wa Workspace register Addrera 

iop Immediate OPerand 

wad Workspace register Address Destination 

disp Displacement of CRU lines from the CRU ^ase register 

exp Expression that represents an Instruction location 

cnt Count of bits for CRU transfer 

sent Shift CouNT 

xop number of extended OPeration 

Source statements that contain machine instructions can use the label field, the 
op^ation field, the operand field, and the comment field. 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
address) before assembling a machine instruction. 

The operation (op-code) field contains the mnemonic operation code of the 
instruction. The contents of the operand field are defined for each instruction. 

Inclusion of the comment field is optional. If used, it may contain any ASCII 
characters, including blanks. The comment has no effect on the assembly process 
other than being printed in the listing. 

In the execution results, the following conventions are used. 

( ) Indicates "the contents of." 

=> Indicates "replaces." 

* * Indicates "the absolute value of." 

The generic names used in the syntax definitions are also used in the execution 
remilts. 



EDITOR/ ASSEMBLER 

Page 106 



JUMP AND BRANCH INSTRUCTXPIS^ 



7.1 BRANCH~B 
Op-codes 0440 ff^orrnat VI) 
Syntax definition: 

[<label>J b B b <gas> b [<comment>] 
Example: 

LABEL B ©THERE Transfers control to location THERE. 

Definition: 

Replaces the Progrstni Counts tiontents with the source address and transfers 
control to the instruction at that location. 

Status bits affected: 
None. 

Q 1 2 3 A 5 6 7 8 9 10 11 12 13 14 15 

|L>1A>IEQ|C IQVIQPIX 1 1 INT. tvV\5K I 



Execution results: 
(gas) => (PC) 

Application notes: 

The B instruction transfers control to another section of code to change the 
limaF flow of the procjram. For example, if the contents of Workspace Register 
3 is >21CC, the instruction 

B •3 

causes the word at location >Z1G0 to be tiited as ttio next inMietli^ bmsmm 
this value replaces the contents of the Program Counter when this instruction is 
executed. 

See Section 24.11.3 for using the B ins^ucUon to rettmi to the calling program. 
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7.2 BRANCH AND LINK— BL 

dp-codes 0680 (F ormat VI) 
Syntax definition: 

[<label>] b BL b <ga8> b [<comment>] 
Example: 

LABEL BL (fSUBR Calls SUBR as a common Work^ace subroutine. 
Definition: 

Places the source address in the Program Counter, places the address of the 
instruction following the BL instruction (in memory) in Workspace Register 11, 
and transfers control to the new PfoQt&tn Counts contents. 

Status bits affected: 
None. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| L>|A>|EQiC IQVIQPIX i --I INT. MQ^SK I 

Execution reeultss 

(old PC) a> (Workspace Register 11) 
(gas) => (PC) 

Application notes: 

The BL instruction returns linkage. For sxample, If the InetruciUOn 

BL @TRAN 

occurs at memory location >04BC, this instruction has the effect of placing 
memory locatidii TRAN 1^ the Program Counter. Since the instruction BL 
@TRAN requires two words of machine code (which are placed at addresses 
>04BC and 04BE), the word address immediately following the second word is 
>04C0 so that value is the address placed in Workspace Register 11. 
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7.> BRANCH AND LOAD WORKSPACE POINTER— BLWP 

Op-code: Q400 (Format VI) 
Syntax definiUon: 

E<label>] b BLWP b <ga8> b t<t!ommBnt>3 

Elxample: 

LABEL BLWP @VECT Branches to subrotitSnA at J^Wress (@VECT+2} 

and executes context switch. 

Definition: 

Places the source operand in the Workspace Pointer and the word immediately 
following the source Opm^nd in the Program Counter. Places the previous 
contents of the Workspace Pointer in the new Workspace Register 13, places the 
previous contents of the Program Counter (address of the instruction following 
BLWP) in the new Workspace Register 14, and places the contents of the Status 
Register in the new Workspace Register 15. When ail store operations are 
Gomfsli^e, the aiimtMJttt' ^an»^^ cenirol to the new Program Counsel'. 

Slaius bits affected: 
None. 

0123456789 10 11 12 13 14 15 
l L>iA>lEQiC IQVIOPIX 1 1 INT. M^SRH 

Execution remits 

(gas) => (WP) 
(gas + 2) => (PC) 

(old WP) => (Workspace Register 13) 
(old PC) => (Workspace Register 14) 
(ST) => mxffkupm^ RegletOT 15) 

Application notes: 

The BLWP instruction links to subroutines, program modules, or other programs 
that do not necessarily share the calling program's workspace. See Section 7.20.3 
for an example of using thd BUNP iW^xmtUm* 
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7.4 3UMP IF EQUMUr^Q 

Op-code: 1500 (Format II) 
Syntax definition: 

i<labeD] b JEQ b <exp> b [<cGmment>] 

Example: 

LABEL JEQ LOC Jumps to LOG if EQ = 1. 

Definition: 

When the equal status bit is set, transfers control by adding the signed 
displacement in the instruction word to the f^o^am Counter and ttwit ptmsim the 
sum In the Program Counter to transfer control. 

Status bits tested: 
Equal. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 13 
i l>Ia>ieq1c lOViOPiX I---- I INT, mSK I 

Jump If: EQ SI I 



Status bits affected: 
None. 



I L>1A>IEQ|C IQVICPIXl 



5 6 7 a 9 10 11 12 13 14 15 

msK 1 



INT 



Execution results: 



If the equal bit is equal to 1: (PC) + Displacement => (PC). 
If the equal bit is equal to 0; (PC) => (PC). 



Application notes: 

WImSr JEQ' Instruction transfers con^ol when the equal status bit is set. 
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7.5 JUMP IF GREATER THAN— JGT 

Op-code: 1500 (Format II) 
Syntax definitions 

[<label>] b JGT b <exp> b [<connnnent>] 



Example: 

LABEL JGT 



THERE 



Jumps to THERE if A> = 1. 



Definition; 

When the etrithmetic greats' thin et^t^ Mk It mts ^ 
in the instruction word to the PPoigtsm 0»|«P pims&s to mm to 
Program Counter. Transfers control to the new Program Counter location* 

Status bits tested; 

Arithmetic greater than. 

7 8 9 10 11 12 13 14 15 



| L>iA>|EQ[C iQVIOPIxn 



INT. MASK 



Jump if: A> = 1 

Status bit affeotedi 
None. 



0 



3 4 



8 9 10 11 12 13 14 15 



1 L> A>1EQ|C OVIOPIX 



INT. MASK 



Execution results: 

If the arithmetic greater than bit is equal to 1: (PC) + Displacement => (PC). 
If the arithmetic greater than bit is equal to 0; (PC) => (PC). 

Application not^ 

The JGT instruction transfers control if the arithmetic greater than status bit is 
set. 
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7^ 3UMP IF HIGH OR EQUAL— JHC 

Op-code: 1400 (Format 11) 
Syntax definition: 

[<label>] b JHE b <exp> b C<comnrient>3 

Example: 

LABEL JHE BLBD Jumps to location SLBO if either EQ or L> is 

set. 

Definition: 

WiieHv-it^ e^b^ .«tatU8 bit or the iogipal greater than status bit is set, adjds the 
signed di^lacement in the ir^uei^ word to the Program Cpuntjw and refiiaces 
the contents of the Program Counter with the sum. 

Status bits tested: 

Logical greater than, equal. 

0 1 2 3 £i 5 6 7 8 9 10 11 12 17 14 15 
1L>|A>IEQ|C IQVIOPIX 1 1 INT. M^iSK | 



Jump if: L> = 1 or EQ = I 

Status bits affected: 
None. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



|L> |A> lEQ C^OV OP X 1 INT. fvnSK i 



Execution results: 

If the logical greater than bit is equal to 1 or the equal bit is eiq^^ to 1: 
(PC) + Displacement => (PC). 

If the logical greater than bit and the equal bit are equal to 0: 



Application notes: 

The JHE instruction transfers control when either the logical greater than or 
equal status bit is set. 
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7.7 JUMP IF LOGICAL HIGH—JH 

Op-code: IBOO (Format II) 
Syntax definition: 

[<label>] b JH b <exp> b [<comment>j 



LABEL JH 



CONT 



If L> equals 1 and EQ equals 0, skips to CONT. 



Definition: 

When 1^ i^fiial Mt h reaat laid ^ logical greater tlian i^ittm bit fo 

adds the signed displacement iti tfm instruction word to die gcintents of the 
Program Counter and replaces the Program Counter witii the sum. 



Status bits tested: 

Logical greater than, equal. 

D 



|L>|A>|£Q(C iQVlOPiX 



7 8 9 10 11 12 13 14 15 



INT. MASK 



Jump if: L> = 1 and EQ = 0 

Status bits affected: 
None. 



0 



10 11 12 13 14 15 



|L> iA>|EQ|C OV OPIX 1 i INT. N4^SKj 



Execution results: 

If the logical greater than bit is equal to 1 and the equal bit is equal to 0: 
(PC) + Displacement => (PC). 

If the h0s^&^ ^&Biter than bit is equal to 0 or the equal bit is equal to Is 
(PC) => (PC). 

Application notes: 

The JH instruction transfers control when the equal status bit is reset and the 
logical greater than status bit Is set. i 
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7.B 3UMP IF UOOlCAl- l-0«— 31. 

Op-code: lAOO (Format U) 
Syntax definition: 

[<label>] b JL b <exp> b [<comment>] 
Example; 

LABEL X PREVLB If L> and EQ are reset, jumps to PREVLB. 

Definition: 

Wi^en the equal and logical greater than status bits are reset, adds the signed 
dii^li^ittefYt in the instruction word to the Program Counter contents and 
replaces the Program Counter with the sum. 



Status bits tested: 

Logical greater than, equal. 



0123456789 10 XI 12 13 14 15 
1 L>IA>|EQ1C iOVIOPlX I 1 INT. MfKSK I 

Jump if: L> = 0 and EG = 0 



Status bits affected: 
None- 



0 1 



7 8 9 10 11 12 13 14 15 



L>|A>i£Q|C IQVIQPIX I---- INT. IW\S^n 



Execution results: 

If the logical greater than bit and the equal bit are equal to 0: 
(PC) + Displacement => (PC), 

If the iogicai greater Umn is equal to 1 ^ the eqmdi tAt Is to li 

(PC) => (PC). 



Application notes: 

The JL instruction transfers control when the equal and logical greater than 
status bits are reset. 
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7.9 JUMP IF LOW OR EQUAL— JLE 

Op-code: 1200 (Format II) 
Syntax definition: 

[<label>] b JLE b <exp> b [<comment>] 
Example: 

LABEL XE THERE Jumps to THERE when EQ = 1 or L> = 0. 

Definition: 

When the equal status bit is set or the logical greater than status bit is reset, 
fl^ddlB the signed displacement in the ^struction word to the contents of the 
Program Counts and replaces the Program Counter with the sum. 

Notex JLE is not "jump if less than or equal." 

Status bits tested: 

Logiaal greater than, equal. 



0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
1L> A>|EQ|C lOVlOPlX I I INT. MftSK I 



Jump if: L> = 0 or EQ = 1 

Status bits affected! 
None. 

0 1 2 3 4 3 6 7 B 9 10 11 12 13 14 15 

I L>IA>|EQ|C lOVlCPiX I- — - I INT. M^SRH 

Execution results: 

If the logical greater than bit is equal to 0 or the equal bit is equal to Xi 
(PC) + Displacement (PC). 

If the logical greater than bit is equal to 1 and the equal bit is equal to Os 
(PC) => (PC). 

Application notess 

The XE instruction transfers control when the equal status bit is set or the 
logical greater than status bit is reseL 
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7.10 aUMP W UESS THAN— JLT 

Op-code: 1100 (Format II) 
Syntax deMtlQin: 

[Cabel>3 b XT b <exp> b i<comment>] 

Example; 

LABEL JLT THERE Jumps to THERE if A> = 0 and EQ = 0, 

Definition: 

When the equal and arithmetic greater than status bits are reset, adds the signed 
displacement in the instruction wortf to the Program Counter and rl^ces the 
Program Countw contents with the sum. 

Status bits tested; 

Arithmetic greater than, equal. 

0 1 2 3 4 5 6 7 8 9 ID 11 12 13 14 13 
I L>1A>IEQIC lOVIOPlX 1 1 M^SK~1 

Jump if: A> s 0 and E0 s 0 

Status bits affected; 
None. 

G 1 2 3 4 5 6 7 8 9 10 11 12 13 14 13 

| L>1A>IEQ|C IQVIOPIX 1 1 INT. M^SK I 

Execution results;. 

If the arithmetic greater than bit and the equal bit are equal to 0: 
(PC; + Displacement => (PC) 

If the arithmetic greater than bit is equal to 1 or the equal bit is equal to Is 
iPC) => (PC). 

Application notes: 

The JLT instruction transfers control when the equal and arithmetic greater than 
status bits are reset. 
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7.11 UNCONDITIOISIAL JUMP— JMP 

Op-code: 1000 (Format XI) 
Syntax definition: 

[<label>] b JIvlP b <exp> b [<comment>] 
Example: 

LEAVE JMP >11A3 Jumps to address >11A3 if it is within >10d 

bytes of the current address. 



Definillome 

Adds the signed displacement in the instruction word to the Program Counted and 
replaces the Program Counter with the sum if the sum is within >100 bytes of the 
current Program Counter. 



Status bits affected: 
None^ 



0 



8 



10 11 12 13 14 15 



|L>|A>|EQ|C lOVlOPIX I I INT. MASK 



Execution results: 

(PC) + Displacement => (PC) 

The Program Counter is always incremented to the address of the next instruction 
prior to execution of an instruction. The execution results of jump Instructions 
refm to Progfam Counter contents aftw the contents have been incremented 

to address the next instruction in sequence. The displacement (in words) is 
shifted to the left one bit position to orient the word displacement to the word 
address, and added to the Program Counter contents. The sum must be within 
>100 bytes of the current Prog^m Counter. 



Application notes: 

The JMP instruction transfers control to another section of the program. 
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7.12 3UMP IF NO CARRY— JNC 

Op-code: 17Q0 (Format II) 
Syntax definitJore 

C<iabei>] b JNC b <exp> b [<comment>] 
Example: 

LABEL aNC NONE Jumps to NONE if C = 0. 

Definition; 

When £^ carry status bit is reset, adds ttm Mgiied displacement In th^^tf^ueAi 
word to the Program Counter and replaces the Program Cdunter with the sum. 

Status bits tested: 
Carry. 

0 1 2 3 4 5 6 7 t 9 XQ 11 12 13 14 15 

1 L>IA>1EQIC IQVIQPIX 1 | IN^ NV\SK I 

Jump if: C a 0 

Status bits affected: 
None. 

0 1 2 3 4 3 6 7 8 9 10 11 12 13 14 15 
| L>|A>iEQlC lOVlOPlX 1 1 INT. MASK i 



Execution raiults; 

If the carry bit is equal to 0: (PC) + DisplacemBrt£^> (PC)» 
If the carry bit is equal to Is (PC) => (PC), 

Appiloetlon notes: 

The JNC instruction transfers controi when the earrf status l3if^fs^^^d^ -'> ' 
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7.1> JUMP IF NOT EQUAL— JNE 

Op-code: 1600 (Format II) 
Syntax definition: 

[<label>] b JNE b <exp> b [<comment>] 
Example: 

LABEL JNE L0C2 Jumps to L0C2 if EQ « 0. 

Definition: 

When the equal status bit is reset, add« the idgmd displacemmt In the instFUction 
word to the Program Counter and replaces the Program Counter wit^ the sum. 



Status bits tested: 
Equal. 

0 1 2 3 4 5 6 7 B 9 10 11 12 13 14 15 

l L>lA>lEQiC lOVIOPlX — I INT. M^SK I 

Jump if: EQ = 0 



Status bits affected: 
None. 

0123456789 10 11 12 13 14 15 
I LMAXEQIC IQVIOPIX I I INT. M^SK~ 1 



Execution results: 

If the equal bit is equal to 0: (PC) + Displacement => (PC). 
If the equal bit is equal tq 1: (PC) => (PC). 

Application notes: 

The JNE instruction ^^nefers control when the equal status bit is reset. For 
instancei JNE is often useful when testing CRU bits. 
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7.14 JUMP IF NO OVERFUOW^-JNO 

Op-code: 1900 (Format II) 
Syntax de^Elom 

[<label>] b JNO b <e)q)> b [<connment>] 

Example: 

LABEL 3NO NORML JurrHift to NORML if OV = 0. 

Definition; 

When the overflow status bit is reset, adds the displacement in the Instruction 
word to the Program Counter and replaces the Program Counter with the i&ra* 

Status bits testedi 
Overflow. 

0 1 2 3 - .4 . 5 6 7 8 9 10 11 12,13 .14 15 

l L>lA>lEQ^G~^ay^oplx 1 ?Kft. M^^sgi 

Jump OV 8 0 

Status bits affectedt 
None. 

0 12 3 4 5 6 7 - g- 11 12 13 14 15 

l L>iA>lEQlC lOVlOPlX — -I INT. lvy\Spn 

Execution results: 

If the overflow bit is equal to 0: (PC) + Displacement => (PC). 
If the overflow bit is equal to 1: (PC) => (PC). 

Application notes: 

The JNO irtilim!^ H-ansfers controT ^Slh^n^ ^^Msw fti^ itU fit l«Mtt»^ JNO 
normally transfers conbfil'dMig dd^j»M3e%^^ ackHtlon, 
subtraction, incrementing, and decrementing may cause sn overflow condition. 
JNO may also be used following an SLA (Shift Left Arithmetic) operation. If, 
during SLA execution, the sign of the Workspace Register being shifted changes, 
the overflow status bit is set. This feature permits transfer, after a sign change, 
to error correction routines or to another functlonei code sequence. 
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7-15 aUMP IF ODD PAR1TY--30P 

Op-Godes ICOO (Tormat It) 
Syntax de^nition: 

[<label>] b JOP b <exp> b [<comment>] - 
Example; 

LABEL JNP THERE Jumps to THERE if OP = 1. 

Definition; 

Whan the odd parity status bit Is set, adds the signed dj^i^»em»lf Ifi the 
instouction word to the Program Counter and replaces the Prd)g^<Bm Counte^^With 
the sum. 

Status bits tested: 
Odd parity. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

[ L>|A>1EQ1C lOVlOPIX 1 INT. M^SK~| 

Jump if; OP = 1 



Status bits aff eeteds 
None. 



10 11 12 13 14 15 



| L>|A>|EQ|C lOViOPfX 



INT. msK 



Execution results: 

If the odd parity bit is equal to 1: (PC) 
If the odd parity bit is equal to Qt 



I- Displacement => (PC). 
s> (PC). 



Application notes: 

The JOP instruction transfers control when there is odd parity. Odd parity 
indicates that there is an odd number of logic one bits in the byte tested. JOP 
transfers t^itM if ^ byte tMted contalriis an Odd number of logic one blt^ 
This iTOtn^tien may be used in data transmissions where the parity of the 
transmitted byte is used to «:i8Lfl^ the validity of the received character at the 
point of reception. 
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7M JUMP C3N CARRY-^JOC 

Op-code: 1800 (Format II) 
Syntax dafinitlont 

[<l«b6l>] b JOC b <exp> b (<cdmmBnt>] 

Example: 

LABEL JOC PROCED If C * 1, Jun^ to PROCED. 
Definition: 

When the carry status bit is set, adds the signed displacement in the instruction 
word to the Proc^am Counter and replaces the Program Counter wttfi the aiiiili^ 



Status bite tettadi 
Carry. 

0 1 2 3 4 5 6 7 8 9 IGi: ^1^. 

l L>iA>IEQIC ^OytQPiX I i INT> MfKSK. [ 

Jump Ifi O * X 

Status bits affecteds 

None. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l L>iA>iEQiC IQVICFiX — \ INfT. t/^K 1 

Ekaeutton faaiittst 

If the carry bit is equal to 1: (PC) + Displacement s> (PCX 
If the carry bit is equal to Qt (PC) (PCX 

Application notes: 

The JOC Instruction transfsrs contitil when the carry status bit is set* 
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7.17 RETURN WITH WORKSPACE POINTER— RTWP 
Op-code: 0380 (Format VII) 
Syntax definitiom 

[<label>] b RTWP b [<comment>] 

LABEL RTWP j^eturfis firom subroutine called by BLWP. 

Definition: 

Rfft^^pes the contenjts of the Workspace Pointer Register with the contents of tkm 
. :eiimtnt WorkopMii^Ri^l^lfcar 13. Replaces &m eotHents of Vtm Program Countor 
with the contents of the current Workspace RegistOT 14. Replaces the contents 

of the Status Register with the contents of the current Workspace Register 15. 
The effect of this instruction is to restore the execution environment that existed 
prior to an interrupt, a BLWP instruction, or an XOP instruction. 

Status bits affected: 

Restores aU status bits to the value contained in Workspace Register 15. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
i L>IA>IEQIC igyiOPfX ^-^l INT. MfiSK I 

Execution results: 

(Workspace Register 13) => (WP) 
(Workspace Register 14) => (PC) 
(Work^ace Register 15) s> (ST) 

Application notes: 

The RTWP instruction restores the execution environment after the COmplethNt Of 
an interrupt, a BLWP in^tructioni or an XOP instruction. 
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7.18 EXECUTE— X 

Op-code: 0480 (Format VI) 
Syntax definition: 

[<label>] b X b <ga3> b [<comment>] 
Example: 

LABEL X 2 Executes the contiMits of Workspace Register 2. 

Definitions 

Exeeutoe 1^ source operand as an instructHlt^ tN» source operaiwd l» iiot a 

single woed itl8t»ie^onf ^ word or m&tdit fdikiwing Hie esdie^ild imtaue^^m lae 

used with the source operand as a 2-word or 3-word instruction. The source 
operand, when executed as an instruction, may affect the contents of the Status 
Register. The Program Counter increments by either one, two, or three words 
depending upon the source operand. If the executed instruction is a branch, the 
branch is taken. If the executed Instruction is 6 Jurflp and if the conditions for a 
jump (i.e. the status test indicates a jump) are sAUefled, then ^ Iwnp to taken 
relative to the location of the X instruction. 

Status bits affected: 

Nonoj but substituted instruction affects status bits n&rmally. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>|A>1EQ1C IQVIQPIX [TTTT- - , .\ int. M^SK I 



Execution results: 

An instruction at gas is executed instead of the X instruction. 



Applieatton notest 

The X instruction executes the souFoe opwand as an Instruction. This is 
primarily useful when the instruction to bft executed is dependent upon a variable 
factor. Refer to Section 7.20 for additional application notes. 
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7.19 EXTENDED OPERATION— XOP 

Op-Gode: 2C00 (TofmBt IX) 
Syntax definition: 

[<label>] b m3P b <gaa>,<xop> b E<comfB«i^] 
Example: 

LABEL XOP @BUFF(4),1 Performs XOP 1 on the word of the address 

BUFF plus the (Hsplacement specified by 
Workspace Register 4. 

Definition: 

This instruction is on all TI-99/4A Home Computers. However, some only 
support XOP 2 while others support both XOP 1 and XOP 2. To find out if your 
TI-99/4A compute supports the XOP 1 instruction, run CALL. PEEK in TI BASIC 
and read one wisrd at ^d^mt >44» tf wmi if >FFD8, then XOP 1 is 
available. If it contains other data (most likely >FFE8), then XOP 1 is not 
available. 

The op field specifies the extended opwatlon ^smsfiBr veotsr in memory* Thd 
two memory words at tkmt iocatton eon^n Uie Wi»k8pace PMlw and Program 
Counter contents for the software implemented XOP instruction subroutine. 
Note that the two memory words at this location must contain the necessary 
Workspace Pointer and Program Counter values prior to the XOP instruction 

execution fm ^(xftw&m imp^^mfrjtad irHStruettans^ 

XOP 1 is at address >44, with vectors >FrD8 and >FFr8. >apP 2 ii Ut address >48 
with vectors >83A0 and >8300. The first entry in the vector is the new 
workspace address. The second entry is the new Program Counter address. 

* 

When the compute is toned on, XOP 1 is set tfi to be used witli development 
software used by Texas Instruments. However, if you have XOP I you may 
modify the data for your own use. 

The effective adch'ess of the source operand is placed in Workspace Register 11 of 
the XOP work4>ace. The Wc^space Pointer contents are placed in Workspace 
Rei^^ 13 )^ m^^^s^mm* Ths Pp»gH»m C^it^ coe^«& wm pWmA U 

Workspace Regiet^ 14 of the XOP workspace. The Status contents are placed in 
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Vi/tnrkspace Register 15 of the XOP workspace. Control is transferred to the new 
Program Counter address and the software implemented XOP is executed. (XOP 
execution of software implemented XOP instruction is similar to an interrupt trap 
execution.) 

Status bits affected: 
Extended operation. 

° 7 ° ^ ^° 

| L>iA>lEQIC lOVlOPIX I I INT. WMKI 

Execution results: * 

gas s> (Workspace Register 11) 
OOOAO + (op)*4) => (WP) 
O0042 + Cop)*4) => (PC) 
(WP) => (Workspace Register 13) 
(PC) => (Workspace Register 14) 
(ST) => (Workspace Register 15) 
1 x> X (XOP status bi^ 
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7.20 INSTRUCTION EXAMPLES 

Thore are two types ef iobftiiit^ SrlUipei «yiM>le with the Anenil^^. One 
esUed a common wc^ks^e aufatoi^ne^ om the same ae^ of WoFk«pEiee Raglites^ 
that the calling routine uses. The BL instruction storea contents of the Program 
Counter in Workspace Register II and transfers control to the subroutine. 

tlie oMr ^pm It a context switch sutvoutihe. The BUNP instruction stores the 
contents of the Wbricapace Pointer Register, the Program Counter, and the Status 

Register in Workspace Registers 13, 14, and 15. The instruction m^es the 
subroutine workspace active and transfers controi to the subroutine. 



7.20.1 Common Workapoeo Subroutine Example 

The following is an example of memory contents prior to a BL call to a subroutine. 
The contents of Workspace Register 11 are not important to the main routine. When 
the BL instruction is executed, the CPU stores the contents of the Program Counter 
in Workspace Register Hof^ main routine and transfm eotitttA Um Instruction 
liiealed at the addrass indicated by the opmnd of the BL inatriietlan* TN^ type of 
subroutine uses the main program workspace. The second example shows the memory 
contents after the cail to the subroutine with the BL instruction. 

When Hi? In^ltistion at location >1130 is executed (BL giRAD), the present contents 
of tSm Pr^igram Counter, v^itch pc^t to the next instruction, are saved in Workspace 
Register 11- Workspace Register 11 would then contain an address of >1134. The 
Program Counter is then loaded with the address of label RAD, which is address 
>2220. This subroutine returns to the main program with a branch to the address in 
Workspace Register 11 using the B *11 instruction. 
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+ -- 

MIP I >A100 

1^ ^ V • liB Mi W •■'■A W'i 



— + 

I 



+ --,-•-- + 

PC I >B134 I 
+ + 

ST I EXECUriON 1 
I STATUS I 
+ + 



+ — ■ — — + 

= = * ^ >A100 I MMN WORKSPACE i (WRO) 

+ + 

r + + 

->B020 1 MAIN PROGRAM | 

I I 

>B130 I BL ©RAD | 
>B134 I JNE FIX I 

I I 
+ + 

>C22Q I RAD ... I 
I I 

t ! 
I B •ll I 

Common Workip«e9 .Sybsipullnii^Exarnpl^ 
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hWlDWARE 
REGJSTEF^ 

WP I >A100 

+ — ------- 



K€M3RY 
ADDRESS 



- -+ 



tmim^ VALUE 
+ 



S se S9 



= => >A100 I Mi\IN WORKSPACE 



(mo) 



>miM 



(WRll) 



+ + 

>B020 I MMN PROGRAM 1 

1 I 
>B130 I BL gRAD I 
>B134 I JtsE FIX i 

I I 
+ + 



PC I >C220 

+ ■ 



= = => >C220 



+ + 

ST I EXECUTION I 
I STATUS I 
+ --- + 



i RAD ... 
I 

I SUBROUTINE AREA 



B 



«11 



PC Contents after BL Instruction Execution 



7.20.2 Context Switch Subroutine Example 

This example shows the memorsr l^xntents prior to the call to the subroutine. The 
contents of the subroutMi Woil^spa^ Rfii^at^ I^, 14» an^ ore not signili^e. 

When the BLWP instruction is executed at location >0300, there is a context switch 
from the main program to the subroutine. The context switch then places the main 
program Program Counter, Workspace Pointer, and Status Register contents in 
Workspace Roisters 13» and X3 of the subroutine. This saves the environment of 
the main progrann fear use on return. The epimmA of %tm SLWP toi^uction speeifies 
that the address vector for the context switch is in Workspace Registers 5 and 6. 
The address in Workspace Register 5 is placed in the Workspace Pointer Register, and 
the address in Workspace Register 6 is placed in the Program Counter. 
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HARDWARE 
REGISTERS 

WP I >A100 



PC 



>A502 



ST i EXECUTION | 
I STATUS i 
+ + 



IvENDRY 

ADDRESS MQvCRY VALUE 

+ + 

:> >A100 I I 

+ + 



>AZ60 

>A300 
>A302 



>A220 



>A700 



>A220 I 
+ 



(WRO) 

(vyR5) 
cvm)s 

(VIR14)S 

(W15)S 



I MMN PRCGRAM 
I 

1 BLWP 5 

1 

I 



>A700 I START 
I 

I SUBROUTINE AREA 
I 

1 

1 RTVVP 



(WNr) = Workspace Register of Main Program 
(WNr)S = Workspace Register of Subroutine 

Context Switch Subroutine Exannpie 

After the instruction at location >0300 is executed, the Workspace Pointer points to 
the subroutine workspace and the Program Counter points to the first instruction of 
the subroutine. The contents of the Status Register ate not reset prior ^ ttw 
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execution of the first instruction of the subroutine, so the status indicated will 
actually be the status of the main program execution. A subroutine may then 
execu^ ciBIMmteg m Iht iiaftp th» main fMOgMMriw 



tvENCRY 

>A10Q I 1 



(V\IK0) 



I >A220 I (VUR5> 

I >A700 I (\MR6) 

+ + 



VIP I 

♦ 



■+ +• 
U IS . = s> >A220 I 



I (¥ra>s 



I >A100 
I 

I >A302 
I 

I STAIUS 



I 

I (VUR14)S 
I 

I (¥R1S)S 



+ • - + 

yA260 I MIVIN PROGRAM | 

I I 

>A300 I BLWP 5 I 

I I 

I I 

4. , + 



PC I >A700 



= s s s «> >A700 



+ + 

ST I EXECUTIGN i 
I STATUS t 
+ ♦ 



+ + 

I START I 
I I 
I SUBROOTINE AREA 1 
I I 



I 

I RVNP 



I 



(WNr) = Workspace Register of Main Program 
QMslr)S = Work^wce Raglater of SuteomOna 



Aftvr^aMa^on of BLWP Instruction 



)£QITOR/ ASSEMBLER 

Page 131 



JUMP AND BRANCH INSTRUCTIONS 



This example subroutine contains a RTWP return from the subroutine. Control la 
transferred to the main program at the instruction following the BLWP to the 
subroutine. The Status Register is restored from Workspace Register 15 and the 
Workspace Pointer points to the workspace of the main program. 



REGISTERS 

+ 

WP I >A100 
+ 



ADDRESS 
>A100 



IvEKCRY VALUE 



>A220 



PC 



>A302 



=> 



>AZ60 

>A300 
>A>02 



>A700 



ST 



+ + 

I EXECUTIGN l<s = s = 
I STATUS I 
+ .-^...4. 



(WNr) = Workspace Register of Main Program 
(WNr)S = Workspace RegistN' of Subroutine 



>A220 



I >A700 
+ 



I >A100 
I 

I >A3a2 

I 

I STATUS 



MMN PROGRAM 



I 
I 

I BUMP 5 

I 

I 

+ 



START 



(WR5) 



I (^)S 



I (W13)S 
I 

I (WR14)S 

I 

I (WR15)S 



I 
I 
I 
I 
I 

•+ 

+ 
I 



I 

I SUBROUTINE AREA | 
I I 
I I 
I RTWP I 
+ + 



Aftm Return using the RTWP Instruction 
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7.20^ Pawing Datu, ^ ^^abrouUiM 

When a subroutine is entered with a context switch (BLWP), data may be passed using 
either the contents of Workspace Register 13 or 14 of the subroutine workspace. 
Workspace Register 13 contains the memory address of the calling program's 
wt^kspace, which may cocitin^ didte lo tm pmnad to lha snAffo^ttiflls Wa^sapam 
PU^^Hr 14 eem^lm the mamt^ tSSOtma ai Urn naxc mmmy location iNiUoiii^ Iho 
BLWP instruction. This location and fidlowtng locations nuiy also contain data to ba 
passed to the subroutine. 

When the calling program's workspace contains data for the subroutine, this data may 
be obt^ned 1^ using the indexed memory address mode indexed by Workspace 

Register 13. The address used is equal to twice the number of the Workspace 
Register that contains the desired data. The following instruction is an axanr^le. 

IvlOV @10(13),R10 

The contents of Workspace Register 3 of the calling program's workspace (bytes 10 
and 11 relative to the workspace address) are placed in Workspace Register 10 of the 
subroutine workspace. 



EDITOR/ASSEMBLER 
Page 133 



The foUowVng examples shovj the passing of data ^ t^MrOd^M^^ flfoi^ data 
following the BLWP insmictian. 



BLWP 
DATA 
DATA 
DATA 
JEG 



@SUB 
VI 
V2 
V3 

ERROR 



p, i .V-P J^ 



Subroutine call. 

Data. 

Data. 

Data. 

Return from subroutine, test for 

error. (The subroutine sets the 
equal status bit to one for error.) 



SUB 



DATA SlDBWS^SUBm© 



Entry point fc^vSUA &^JB 
W^H^ace. 



SUBWS BSS n 

SUBPRQ MOV n4+,l 

MOV n4+,2 

MOV *14+,3 



V'ieHsdhrVl placed in Workspace 

Register 1. 

Fetch V2 placed in Workspace 

Register 2. 

Fetch V3 placed in Workspace 
RegUter 3. 



RTWP 



Return from subroutine. 



The three MOV instructions retrieve the vnrlables from the ftindgi ps^ogram module and 
place them In Workspace Registers one, two, and three of the subroutine. 

When the BLWP instruction is executed, the main program module status is stored in 
Workspace Re^eter 15 of tfie miftHmiQne. if 0w sutnmitifie I'etums wtl^ a RTWP 
instruction, this status is placed In the Status RegistM' after the RTWP instruction is 

executed. The subroutine may alter the Statutt Register contents prior to executing 
the RTWP instruction. The calling program can then test the appropriate bit of the 
status word (the equal bit in this example) with jump instructions. 
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A BL instruction can also be used to pass parameters to a subroutine. When usir^ 
this instruction, the originating Program Counter value is placed in Workspace 
Register 11. Therefore, the subroutine must fetch the parameters relative to the 
contents of Workspace Register 11 rath^ thm contents of W<E»|{e^aGe Me^trar 14 
^ to tl» BtWP eMtiple. The following example dWPMl^Mlt fmmm0tm pm&m 
with a BL instruction. 



BL @SUBR 

DATA PARM1,PARM2 

JEQ ERROR 



Branch to subroutine. 

Pa^d paranrtdtiars Mtmmi In r3m% 

two memory words. 

Test for error, (Subroutine sets the 

equal status bit to one for error.) 



SUBR 



EQU 
MOV 



»R11+,R0 



MOV *R11+,R1 



Get value of first parameter and put 
in Workspace Register 0. 
Get value of second parameter and 
put in Workspace Register 1. (Rll 
Is Increfnented past the locations of 
the tv^o data words and now 
indicates the address of the next 
instruction in the main program.) 



B 



ni 
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7.Z0.4 CxtendBd OpBraUom 

Extended operation instructions permit a limited extension of the existing instruction 
set to include additional instructions. In the computer, these additional instructions 
are tmplemehted by software routines. 

When the program module contains an XOP instruction that is software implemented, 
the compute locates the XOP Workspttoe Pointer and Program Counter ml^ in tbB 
XOP reserved memory locations and loads the Workspace Pointer and Program 
Counter. When the Workspace Pointer and Program Counter are loaded, the 
computer transfers control to the XOP instruction set through a context switch. 
When the context switch is complete, the XOP workspace contains the calling routine 
return data in Workspace Registers 13, 14, and 13. 

The XOP instruetian paam om opaitnd to the XOP (Inpiit lo iha XOP raittltie In 

Workspace Register 11 of the )€PP Workspace). At the completion of the software 
XOP, the XOP routine should return to the calling routine with an RTWP instruction 
that restores the execution environment of the calling routine to that in existence at 



7.20.5 Execute ExamfUs 

The execute instruction may be used to execute an instruction that is not in sequence 
without transferring (Mtrol to the desired Instruction. One useful application la to 

execute one of a table of instructions^ selecting the desired instruction by using an 
index into the table* The computed value of the index determines which instruction 
is executed. 

A ttMB of shift instructions illus^Nilee tfie use of the X instruction. Place the 
following instructions at location TBl-E. 

TBLE SLA R6,3 Shift Workspace Register 6. 



SLA 

TABEND EQU 



R7,3 

$ 



Shift Workspace Register 7. 
ShUfc Workspace Register 8. 
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A character is placed in the most significant byte of Workspace Register 3 to select 
the Workspace Register to be shifted to the left 3 bit positions, ASCII characters A, 
B, and C specify shifting Workspace Registers 6, 7, and 8, respectively. O^ier 
cht^neti^s are ignor^t^ The foltowing code pwforms the s^ection of sMft 
de^ed. 



SRL 


R5,8 


Move to lower byte. 


AI 


R5,-'A' 


Subtract table bias. 


JLT 


NOSHIFT 


lUegaU 


SLA 


R5,l 


Make it a wiM 


CI 


R5JABEM3-TBLE.2 




JGT 


NOSHFT 


Illegal. 


X 


@TBLE(R5) 




Emj = 


f ; 





When uting the X instruction, if the substituted instructton eontains a Ts field or^^^d 
fitid that results in a two word instrtietldn» i3tm Gomputw accesses ^ woiM ft^M^ng 
Hie X Imrtnietion as the second word, not the word following the substituted 
instruction. When the substituted instruction is a jump instruction with a 
displacement, the displacement must be computed from the X instruction, not from 
the substituted instruction. 
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The foUawing compare instruetiems are described in this sectionp 



Ihstruction 
Compare words 
Compare Bytes 
Corripsre Immediate 
Compare Qi^ Cme&Bpmidwg 
Compare Zeros Corresponding 



Mnemonic 



Section 



C 

CB 

CI 



GOC 
CZC 



8.1 
8.2 
8.3 

8.4 

a.5 



Compare instructions have no effect other than the setting or resetting of appropriate 
status t^its in the Ststua Register. The compare in^iriactions perform both arithmetic 
and Logical compari^m^ fim ai^thrrielie oiimp^son k of the two cpsranda as two's 
complement values, while a logical comparison is of the two operands as unsigned 
magnitude values. 

Each instruction consists of the fallowing information. 

■ A heading, consisting of the instruction neme and mnemonic name 

• The op-code 

• The syntax definition 

• An example of the instruction 

• The definition of the instruction 
a The status t^lts aff^ted 

a The execution results 

a Application notes when appropriate 

The QpH30de is a fot^'-digit hexadecimal miiiiiba> whlc^ co^spundB to srt In^usUm 
word whose address fields contain zeros. 
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The syntax definition follows the conventiofw described in Seqtion 5, Thp generic 
names used in the syntax definitions are: 

gas General Adcfresa of the Source operafid 

Qffij General Address of the Destination upersnd 

wa Workspace register Adctress 

iop Immediate OPerand 

wad Workspace register Address Destination 

d!^ DlSPUicefnei^ of C^U Itmt ftom the CHU hsse register 

exp £)0>V8Siian Ulttt ttsp^mmU m instruction location 

cnt Count of bits for CRU tr^rnf er 

sent Shift CouNT 

xop number of extended Operation 

Sourpi9t aiit|9p9l^|^fl3BP^ the label fields the 

operation field» thov operand fields «c«d the cQmm«nt. fields 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
adcfress) befwe assembling a machine instruction. 

The operation (op-code) field contains the mnemonic operation code of the 
instruction. The contents of the operand field are defined for each instruction* 

? _ a - i ^ : ■ ■ • 

Inclusion of the cdmrifantJttiid is optional. If4ttad^ifciiA^C$iima&t^.Ji^II 
characters, including blanks. The comment has no effect on the assembly process 
other than being tainted in the listing. 

In the execution results, the following conventions are used. 

( ) Indteatet "ihe ediAents of.** 

=> Indicates "replaces." 

'**' * Indicates "J^e absolute value of." 

The generic names used .(n the syntax definitions are also used in the execution 
results. 
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8.1 COMPARE WORDS-C 

Op-code; 8000 (Format I) 
Syntax definition! 

C<label>] b C b <ga^,<gad> b [<cOfnm»nt>] 
Example: 

LABEL C 2,3 Compares the contents of Workspace Register 2 

and Workspace Register 3. 

Definition; 

Compos tairoe opmm^ ivfitt^ with the destination operiUid CW^d) and 
sel^^resela the status bits to indicate the t»8ults of th& mtri^im^ The 
arithmetic and equal comparisons compare the operand as signed, two's 
complement values. The logical comparison compares the two operands as 
unsigned, 16-bit magnitude values. 

Status bits affectedt 

Logical greater than, arithmetic greater than, and equaL 

0 1 2 3 4 3 6 7 8 9 ID 11 12 13 14 15 
| L>1A>|EQ10 lOVICPiX [ INT. M<\SI<~I 



Execution results: 

(gas) compared to (gad) 

Application notes: 

The C instruction compares the two operands as signed, two's complement values 
and as unsigned integers. Some examples are: 

Stafctm Bits jet 

Source Destination Loqlcal> Arithmetie> Equal 

>FFFF >0000 X 0 0 

>7FFF >000Q 110 

>8000 >0000 10 0 

>80D0 >7FFF 10 0 

>7FFF >7FFF 0 0 1 

>7FfF >8000 0 1 0 
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An alternate way to compare a word or byte to zoto is to move the word or byte to 
itself. For example: 

mOV RO,RO 
OEQ CXJT 

jumps to OUT If RQ is equal to zero. 
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8.2 COMPARE BYTES— CB 

Op-code: 9000 (Format I) 
Syntax definition: 

[<iabei>] b CB b <gas>,<gad> b [<comment>] 
Example: 

LABEL CB 2,3 Compares the leftmost bytes of Workspaco 

Register 2 and Workspace Register 3. 

Definition: 

C:oiiri|»dres the source operand (byte) with the destination operand (byte) and 
9e^^tm»t& the status bits ac^irdhtg to tUrm result of th0 isiimparison* The CB 

instruction uses the same comparison basis as does the C instruction. If the 
source operand contains an odd number of logic one bits, the odd parity status bit 
is set. The operands remain unchanged. If either operand is addressed in the 
WilHi^ace Register mode, the byte addressed is the most significant byte. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, and odd parity. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I L>IA>1EQIC lOVlOPIX I I INT, MftSK~l 

AAA A 

Execution results: 

(gas) compaired to (gad) 

Application notes: 

The CB instipuetion cOifiparoB ttm two operands as signed, two's complement values 
or as unsigned integers. Some examples are: 



Status Bits Set 

Source Destination Loqical> Arithmetic> Equal Odd Parity 

MJQ >Fr 10 0 0 

>oo >7r 11 0 1 

>7F >80 1 0 0 1 

>7F >7F 0 0 11 

>8G >7F 0 1 0 1 
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8.3 COMPARE IMMEDIATE— CI 

Op-code: Q280 (Format VIII) 
Syntax dennition: 

[<label>] b CI b <wa>,<iop> b [<comment>] 
Example: 

LABEL CI 3,7 Compares the contents of Workspace Roister 3 

to >0007, 

Definitions 

OompWM eonleiito of the specified }Matkspsoe Register with the word in 
Ittemory immediately frdlowing the instruction and sets/resets the status bits 
according to the comparison. The CI instruction makes the same type of 
comparison as does the C instruction. 

Status bits affectedt 

Logical greater than, arithmetic greater than, and equal. 

0 1 2 3 A 5 6 7 8 9 10 11 12 13 14 15 
| L>1A>IEQIC 1€3\^[QPIX j-.-^— — , — .-^1 INT, Mi^jiT"! 

AAA 

Execution results: 

(wa> compared to lop 

Application notes: 

The CI instruction compares the Workspace Register to an immediate operand. 
For example, if the contents of Workspace Register 9 is >2183, the instruction 

CI 9,>F330 

results in the arithmetic greater than status bit being set and the logical greater 
than and equal status bits being reset. 
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8*4 COMPARE ONES CORRESPO^a^ING-COC 

Op-code: 2000 (Format III) 
Syntax definition: 

[<labei>] b COG b <gaa>,<wad> b [<comment>] 

Example: 

LABEL COG @MASK,2 Coirn^es the contents of Workspace Register 2 

with the contents of MASK. 

Definition: 

When the bits in the destination operand WoTk^mce Register that correspond to 
the logic one bits in the ammie iqperand are equal to io^ one, sets the equal 
status bit. The source and destination operands are unchanged. 



Status bits affected: 
Equal. 

0 1 2 3 4 5 6 7 
1 L>|A>|EQ|C IQVIQPIX 1- 



8 9 10 11 12 13 14 15 



I INT. IWXSRn 



Execution results: 

The equal bit is set if all bits of <wad> that correspond to the bits of <gas> that 
are equal to 1 are also equal to 1. 
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Afi^lication notes: 

The COC instruction tests single or multiple bits within a word in a Workspace 
Register. For example, if TESTBI contains the word >C102 and Workspace 
Register B contflArra thift valud >O06, the instruction 

COC STESTBI,8 

sets the equal status bit because for each 1 bit in the first operand there is a 1 
bit in the corresponding bit position of the second operand as shown below. 

>C102 := 1100 0001 0000 0010 and 
>E306 = 1110 0011 0000 0110 

If Workspace Register 8 contains >E301, the equal status bit is reset. Use this 
instruction to determine if a Workspace Register has Is in the bit positions 
in<iicated by the Is in a nnask. 



r , ' 
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COMPARE ZEROS CORRESPONDING— CZC 



Op-codes ^400 format III) 



Syntax definition: 



[<label>] b CZC b <gas>,<wad> b [<comment>] 
Example: 



LABEL CZC @MASK^ Compares the contents of Wcn^space Register 2 

with the contents of MASK. 



Definition: 

Wtien the bS^ in the destination operand Wcrkspfiea Register that correspond to 
the one bits in the source operand are all equal to logic zero, sets the equal 
status bit. The source and destination operands are unchanged. 

Status tiltd Affmt^ 
Equal. 

0 12 3 4 5 6 7 8 9 10 11 12 13 14 15 
|L>|A>|EQ|C lOVlQPlX I | INT. MftSK I 



Execution results: 

The equSl Mi is s&t If all bits of <wad> that correspond to the bits of <gas> that 
are equal to 1 are equal to 0. 



Application notes: 

The CZC instruction tests single or multiple bits within a word in a Workspace 
Register. For example, if the memory location labeled TESTBI contains the 
value >C102, and Workspace Register 8 contains >2301, the instruefcion 

CZC @TESTBI,8 



resets the equal status bit because for each 1 bit in the first operand there is not 
a Gon^B^pM^ing zero bit in the ccnrresponding bit position of the second operand 
as shown below. 



>C102 = 1100 0001 0000 0010 and 
>2301 = 0010 OQll 0000 0001 
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If Workspace Register 8 contains the value >2201, then the equal stotua bit ^ set* 
Use the CZC instruction to det^mine if a Wca>k8pace Register has zeros in the 
positions Indicated, by ones in a mask. 
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The following control and CRU instructiorm wfs described in this action. 



Instruction 
LoaD CRU 



Mnemonic 
LDCR 



9-1 
9-2 

9.4 
9.5 



Section 



Set <MJ Bit to One 
Sea: (MU M% to Zero 



Store CRU 
Test Bit 



mo 

SBZ 

STCR 

TB 



The following instructions are de8(^b«t in Seetlon 9.6. AU of them are properly 
assembled and are recognized by Che TMS9900 microprocessor, but they should not be 
used on the Home Computer. 



Examples are given in Section 9.7. 

Control instructions affect the operation of the Arithmetic Unit (AU) and the 
associated portions of the computer or microprocessor. CRU instructions affect the 
modules connected to the Communications Register Unit. 

For CRU bit instructions, the signed displacement is d^'^ed one bit position to the 

left and added to the contents of Workspace Register 12. In other words, it is a 
displacement in bits from the contents of bits 3 through 14 of Workspace Register 12. 

See Section 24.3.2 for more information. 



Instruction 
ClocK QFf 
ClocK ON 
IDLE 



Mnemonic 



ReSET 

Load or REstart execution 



CKOF 
CKON 
iOi-E 

RSET 
LREX 
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Each instruetion consists of the following information. 

• A heading, consisting of tto in^^uctlOfl mrm and mtieiprforde trmtne 
« The c^-code 

e The syntax definition 

• An example of the instruction 

• The definition of the instruction 

• The status bits affected 

• The execution results 

• Application notes when appropriate 



The op-code is a four-digit hexadecimal number which corresponds to an instruction 
word whose address fields contain zeros. 

The syntax definition follows the conventions described in Section 5. The generic 
names used in the syntax definitions are: 



gas General Address of the Source operand 

gad Genei^i Address of t?ie Destinathiti ibp«rand 

wa Wortopaee register Adtfress 

iop Immediate OPerand 

wad Workspace register Address Destination 

disp Displacement of CRU lines from the CRU base register 

exp Expression that represents an instruction location 

cnt CouNT of bits for CRU transfer 

sent Shift CouNT 

xop number of extended Operation 



Source statements that contain macfHne Inductions can use the label field, the 
operation field, the operand field, and the comment field. 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
address) before assembling a machine instruction. 

The operation (op-code) field contains the mnemonte oration ctKte of tlie 
instruction. The contents of the operand field are defined for each Instruction. 

Inclusion of the comment field is optional. If used, it may contain any ASCII 
characters, Inciudirig blaiks. The comment iias m efTeet on the assembly process 
other than being printed in the Us^^ 
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In the execution results^ the foiiowing conventions are used. 



( ) Indicates "the contents of." 

=> Indicates 'Replaces.*' 

* * Indicates "the absolute value of." 



The generic names used in the syntax definitions are also used in the execution 
results. 
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9.1 LOAD CRU— LDCR 

Op-code: 3000 (Format IV) 

Syntax definition: 

[<label>] b LDCR b <gas>,<cnt> b L<comment>] 

WRITE LDCR @BUFr,15 Sends 15 bits from BUFF to the CRU. 
Definition: 

Transfers the number of bits specifled in the cmt field from the source operand to 
the CRU. The transfer begins with the least significant bit of the source 

operand. The CRU address is contained in bits 3 through 14 of Workspace 
Register 12. When the cnt field contains zero, the number of bits transferred is 
16. If the number of bits to be transferred is from one to eight, the source 
operand address is a byte address. If the number of bits to be transferred is 
from 9 to 16, tlie smiree operand address is a word address. If the source 
operand addrees is odd, the address Is truncated to an even SMfcleawB prior to data 
transfer. When the number of bits transferred is a byte or less, the source 
operand is compared to zero and the status bits are set/reset, according to the 
results of the comparison. The odd parity status bit is set when the bits in a 
byte (or less) to be transferreti e^abUSh odd parity. 



Status bits affected: 

Logical greater than, arithmetic greater than, and equal. When cnt is less than 
nine, odd parity is also set or reset. The odd parity status bit is set according to 
the full word or byte, not just the transferred bits. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



iL>lA>|E:Q|C IQVlQPjX I INT. W5K 1 



Execution results: 

The number of bits specified by cnt are transferred from memory at address gas 
to consecutive CRU lines beginning at the address in Workspace Register 12 (bits 
3 through 14X 
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9^2 SET CRU BIT TO CME— SBO 

Op-code: IDOO (Format II) 
Syntax definition^ 

[<iabei>] .b SBO b <clisp> b [<comment>] 
Examples 

LABEL SBO 7 Sets CRU bit 7, relative to the CRU base in 

Workspace Register 12, to one. 

Definition: 

Sftt^ ^ digital output bit to one on the CRU at the address derived from this 
instruction. The derived m^ims» U the sum of the signed displacement and the 

contents of Workspace Register 12, bits 3 through 14. The execution of this 
instruction does not affect the Status Register or the contents of Workspace 
Register 12. 

Status bits affectedi 
None. 

Q 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I L>|A>|EQ|C lovlOPlx I--- I INfT. MftSK I 

Execution results: 

A CRU bit [« to tm* The CRU bit equals the sum of the contents of 
Work^ace Register 12 (bits J through 14) and the displacement. 
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9.3 SET CRU BIT TO ZERO-SBZ 

Op-code: lEOO (Format II) 
Syntax definition: 

[<label>] b SBZ b <disp> b [<comment>] 

Example: 

LABEL SBZ 7 Sets CRU bit 7, relative to Ihe iDRU buse in 

Workspace Register 12, to zero. 

Definition: 

SeU M digfTM oUtptft Mt to zero on Ch« Cffi at the addi^'dei^^rdd ^is 
instruction. The derived address is the sum of the signed displacement and the 
contents of Workspace Register 12, bits 3 through 14. The execution of this 
instruction does not affect the Status Register or the contents of Workspace 
Register 12, 

SttftOi l^ts affected; 

0 1 2 3 4 5 6 7 B 9 10 11 12 13 14 15 
I L>IA>IEQ|C lOVIOPiX Ir— I INT. mSKl 

■ ■(>-■ . . 

Execution results: 

A CRU bit is set to zero. The CRU bit equals the sum of the contents, jof 
Work^ce Register 12 (bits 3 through 14) and the displacement. 
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9A STORE CRU—STCR 

Op-code: 3400 (Format IV) 
Syntax defmitions 

[<labei>] b STCR b <gas>,<cnt> b [<comment>] 
Example; 

READ STCR liBUF,9 Reads 9 bits from the CRU and stores them at 

location BUT. 

Definition: 

Transfers the number of bits sp^fM in the cnt field from the CRU to the 
3mm& ^ratid. The trans^tiilr begins from tbet CRU address specified in bits 3 

through 14 of Workspace Register 12 to the least significant bit of the source 
operand and fills the source operand toward the most significant bit. When the 
cnt field contains a zero, the number of bits to transfer is 16. If the number of 
bits to transfer is from one to eight, the source operand address is a byte 
^drdas^ Any bit in the memory byte not filled by the transfer is set to zero* 
When the number of bits to transfer is from 9 to 16, the source operand address 
is a word address. If the source operand address is odd, the address is truncated 
to an even address prior to data transfer. If the transfer does not fill the entire 
memory word, unfilled bits are set to zero. When the number of bits to transfer 
is a byte or leasi the bits transferred are compared to zero and the status bits 
are set or reset to indicate the results of the comparison. Also, when the bits to 
be transferred are a byte or less, the odd parity bit is set when the bits establish 
odd parity. 

Status bits affected: 

Ue^lo^ gmit^ t^iXf arithmetie gre^teff than, and equ^ When vt^ to than 
9, odd parity is also set or reset. Status Is set according to the full word or 
byte, not just the transferred bits. 

0 1 2 3 4 3 6 7 8 .9 XP 11 12 13 14 15 
| l->|A>|EQiC lOVIQPiX --{ INT, MASK I 
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Execution results: 

The number of bits specified by cnt are transferred from consecutive CRU lines 
beginning at the address in Workspace Register 12 (bits 3 through 14) to mennory 
at address gaa. 

Application notes: 

The STCR instruction transfers a specified number of CRU bits from the CRU to 
the memory location specified as the source operand. Note that the CRU base 
a^ldmsft mu^ tie to Waricspace Register It (bite 3 through 14) i^^lor to the 
execution of this instruction. 
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9.5 TEST BIT—TB 

Syntax definition: 

[<label>] b TB b <disp> b [<comment>] 
Example: 

CHECK TB 7 Reads CRU bit 7 relative to the CRU base 

address in Workspace Register 12, and sets the 
equal status bit to the value read. 

OelNttion: 

Reads the digital input bit on the CRU at the address specified by the sum of the 
signed displacement and the contents of Workspace Register 12, bits 3 through 14, 
and set the equal status bit to the value read. The digital input bit and the 
oontents of Workspace Re^i^iW 12 are unchanged. 

Status bits affected: 
Equal. 

0 1 2 3 4 5 6 7 a 9 Itt 11 12 13 14 15 

l L>lA>iEQ|C lOVlOPiX 1------- I INT. M^SKH 

ExWition t^Mm 

Equal bit is set to the value of the CRU bit addressed by the sum of the contents 
of Workspace Register 12 (bits 3 through 14) and the displacement. 

Application ftofcesc 

the TB inS^uc^Qtri ttmra^mcB &m f^m the imftcaM CR4J line to the equal 
status bit without modification. If the CRU line tested is set to one, the equal 
status bit is set to one; if the line is zero, it is set to zero. The JEQ instruction 
can then be used to transfer control when the CRU line is one and not transfer 
tm^&l lAThen ^ Hne is zoto. In bittern, the 3NE Ins^uctlon transfers control 
under the opposite conditions. 
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9.6 OTHER IhKTRUCTIOhfi 

The following instructions are properly assembled and are recognized by the TMS9900 
microprocessor, but they should not be used on the Home Computer. Their op-code 
and syntax definition are giv<«[i M^iitf* 



Instruction 


Mnemonic 


Op-code 


Format 


Syntax definition 


ClocK OFf 


CKOF 


03C0 


VII 


[<label>] b CKOF b [<comment> 


ClocK ON 


CKON 


03A0 


VII 


[<label>] b CKON b [<comment>] 




IDLE 


0340 


VIl 


[<lab«J>l b IDLE h [<comment>3 




RSET 


0360 


vii 


[<label>] b RSET b [<comment>] 


Load or REstart 


LREX 


03e;q 


vn 


[<label>3 b LREX b E<comment>] 



execution 
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9,7 CRU INPUT/OLrrPUT 

The Communications Register Unit (CRU) performs single and multiple bit 
programmed input/output. AU Ifh^ i^jflfHIitt^ ^ l^i^eRrii iP^U lif^il^ k»^9^ into 

memory and output mtv^itu of siit^kig CHU output lini>d to bit vfitet fftm m wtard or 
byte of memory. The CRU provides a maximum of 4096 input and output lines that 
may be individually selected by a 12-bit address. The 12-bit address is located in 
bits 3 through 14 of Workspace Register 12 and is the base address for ail CRU 
communii^tions; Bern SactSon ^43^2 fat more information* 

9.7.1 CRU I/O Iratructlona 

There are five instructions for communications with CRU lines. 

SBO Set CRU Bit to One. This instruction sets a CRU output line to one. 

SBZ Set CRU Bit to Zero. This instruction sets a CRU output line to zero. 

TB Test CRU Bit. This instruction reads the digital input bit and sets the equal 
status bit (bit 2) to the value of the digital input bit. 

LDCR Load Communications Register. This instruction transfers the number of bits 
(1-16) specified by the cnt field of the instruction to the CRU from the 
source opeB^mvd. Whan 1^ than nine bito are specified, the soi^oe operand 
address is a byte address. When nfne or more bits specsifled, the source 
operand is a v^^ord address. The CRU address is the address of the first CRU 
digital output affected. The CRU address is determined by the contents of 
Workspace Register 12, bits 3 through 14. 

STCR Store Communications Register. This instruction transfers the number of bits 

specified by the cnt field of the instruction from the CRU to the source 
operand. When less than nine bits are specified, the source operand address 
is a byte address. When nine or more bits are specified, the source operand 
address is a word address. The CRU address is determined by Workspace 
Re^i^er |2« bits 3 through 14. 
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9.7.2 Accessing Spacific Bits 

There are many different ways to access the same CRU bit. For instance, if 
Wori<apace Register 12 contains >Q100, making the base address in bits 3 through 14 
fitlifsA to mi» th^ MbTwins In^tmta «^ t^U mm >85 to one. 

SBO 3 

Alternatively, if Worl<space Register 12 contains >010A, making the base address in 
UtB 3 ttnrough 14 equal to >85, the following instruction sets CRU line >85 to 
one. 

SBO 0 

9.7.3 SBO Example 

Assume that a control device turns on a motor when the computer sets a one on CRU 
line >10F and that Workspace Register 12 contains >0200, making the base address in 
bits 3 through 14 equal to >100, The following instruction sets CRU line >10F to 
one. 

SBO 15 
9^7.4 S&Z Emsmple 

Assume that a control device shuts off a valve when the computer sets a zero on a 
CRU line is connected to CRU line 2 and that Workspace Register 12 contains zero. 
The following instruction sets CRU line 2 to zero. 

SBZ 2 
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9,7*5 TB Example 

Assume that Workspace Register 12 contains >0140, making the base address in bits 3 
through 14 equd to >^ Tfm fallowing h^tri^sli^ft iM to Input on CRU line >A4 
and e^mite the ir^E^ie^cfns beginning at Icmti^ ii^Hen titE t^y Um is set to 
or^ When the CRU line is set to zero, the instructions beginning at location WAIT 
are executed. 

TB 4 Test CRU line 4, 

3EQ RUN If on, fO to RUN. 

WAIT . If off, continue. 



RUN 

The TB instruction sets the equal bit of the Status Register to the level on line 4 of 
the CRU device. 
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The following load and move instructions are described in this section. 



Instruction 


Mnemonic 


Section 


l^QSHd Immediate 


LI 


10-1 


Load Interrupt Mask Immediate 


LIMI 


10.2 


Load Workspace Pointer Immediate 


LWPI 


10.3 


MOVe words 


MOV 


10.4 


iy^s 


MOV# 


10,5 


STdF# STa£us 


STST 


m.€ 


STore Workspace Pointer 


STWP 


10.7 


SWaP Bytes 


SWPB 


10.8 



An example is given In Sac^im 

Load and move instructions permit you to establish the execution environment and the 
execution results. These instructions manipulate data between memory locations and 
between hardware registers and memory locations. 

Espch tneBtoc^on consists of ^ fdlloitving inforfi^itlon^ 

• A heading, consisting of the instruction nanne and miwnonic name 

• The op-code 

• The syntax definition -* • 

m An example of 1^ InAt^ucUon 

• The deflr^tton the induction 

• The status bits affected 

• The execution results 

• Application notes when appropriate 

The op-code is a fouf-iRgit hexadecimal number which oc^responds to an instruction 
word wh(^ address fields contain zeros. 
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The syntax definition follows the conventions d^^ribed in Section 5- The generic 
names used in the syntax definitions are: 



gas General Address of the Source operand 

gad General Address of the Destination operand 

wa Workspace register Address 

iop Immediate OPerand 

wad Workspace register Address Destination 

disp Displacement of CRU lines from the CRD base register 

Bxp EXPresdon ^ivat represents an instruction location 

ant Count of bits for CRU transfer 

sent Shift CouNT 

xop number of extended Operation 



Source dtatemmite that contain mad>lne instructions can use the label fteldf the 
operation field, the operand field, and ttie comment field. 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
address) before assembling a machine instruction. 

The operation (op-code) field contains the mnemonic operation code of the 
instruction. The contents of the operand field are defined for each instruction. 

Inclusion of the comment field is optional. If used, it may contain any ASCII 
characters, Including blanks. The oomment has no effect on tfm aeaembly process 
other than being printed in the listing. 

In the execution results, the following conventions are used, 
( ) Indicates "the contents of." 
* * Indicates "the absolute value of." 



The generic names used in the syntax definitions are also used in the execution 
results. 
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10.1 LOAD IMMEDIATE—Ll 

Op-code: 0200 (Format VIII) 
Syntax definition: 

[<label>] b LI b <wa>,<iop> b [<comment>] 
Example: 

GETIT LI 3,>17 Loads Workspace Register 3 with >0Q17. 

Definition: 

Places the immediate operand (the word of memory immediately following the 
instruction) in the VM^|»aee ^^Ister (W field). The immediate operand is not 
affected by the exftcutldn of tttls instruction. Ttte ifrtmediate operand ts 

compared to 0 and the logical greater than, arithmetic greater than, and equal 
status bits are set or reset according to the result of the comparison. 

Status Mte affectodi 

Logical greater tlian^ arithmetic greater than, and equal. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
1 L>|A>|EQ|C lOVIOPIX I - IMf. i 



Execution results: 
(l«)p) {wm) 

Application notes: 

The LI instruction places an immediate operand in a specified Workspace 
Register. This may be used to initialize a Workspace Register as a loop counter. 
For fticample, the iiwuetlon 

LI 7,5 

initializes Workspace Register 7 with the value >0003. In this example, the 
logical ^eater than and arithmetic greater than status bits are set, while the 
equal status bit is reset. 
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10,2 LOAD INTERRUPT MASK IMMEDIATE— LIMI 

Op-code: 0300 (Format VUl) 
Syntax (tefiriitton: 

[<label>] b LIMI b <iop> b [<commBnt>3 
Example: 

LABEL LIMI 2 Masks level 2 and below. 

Definition: 

Placaa tb» leaat dgnif leant ftmr bit» (bits 12-15) of the contents of ^ immetiUate 
operand (the next word after the instruction) in the interrupt mask of the Status 
Register. The remaining bits of the Status Register (0 through 11) are not 
affected. 

Status bits affected: 
Interrupt mask. 

0123456789 10 11 12 13 14 15 
1 L>IA>IEQIC lOVlCPIX I— ^^^■^.-^-^^.■l INT. M^SR~ I 

" I I r r I ^^^^^ - A A * « 

Execution results: 

Places the four least j^gniffcant bits of Usp into the interrupt maskp 

Application notes: 

The LIMI instruction initializes the interrupt mask so that a particular level of 
interrupt is accepted. For example, the instruction 

LIMI 2 

sets the interrupt mask to level two and enables interrupts at levels 0, 1, and 2« 
The instruction 

LIMI 0 

Disables all interrupts and is the normal state of the computer. 
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X0.3 LOAD WORKSPACE POINTER IMMEDIATE— L.WPI 

Op-code: 02E0 (Format VIII) 
Syr^x definitions 

[<labeD] b LWPI b <lop> b [<comnnent>] 
Example: 

NEWWP LWPI >02F2 Sets tsEWWP equal to >QZF2. 

Definition: 

Replaces the contents of the Workspace Pointer with the immediate operand. 

Status bits affected: 
None. 

0 1 2 3 A 5 6 7 8 9 10 II 12 13 14 15 

| L>|A>|EQ|C lOVIOPIX I — — I INT. I^SKH 

Execution results: 
(lop) => <WP) 

Application notes: 

The LWPI instruction initializes or changes the Workspace Pointer Register to 
alter the Workspace environment of the program. You may use a BLWP or a 
LWPI instruction to load your own Workspace Registers. 
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10.4 MOVE WORD— MOV 



Op-code: COOO (Format I) 



Syntax definition: 



[<iabel>] b MOV b <gas>,<gad> b [<comment>] 
Example: 



GET MOV @WD,2 Moves a copy of WD into Workspace Register 2. 

Definition: 

Replaces the destination operand with a copy of the source operand. The 
computer compares the resulting destination operand to zero and SeWreseU the 
status bits according to the comparison. 

Status bits affected: 

Logical greater than, arithmetic greater than, and equal. 

0 12 3 4 5 6 7 8 9 10 11 12 13 14 15 



L>|A>|EQ|C IQVIOPIX - | INT. M^SK I 

?f ■ ' 



Execution results: 
(gas) => (gad) 

Applte&tlion notes: 

The MOV instruction moves 16-bit words as follows: 



Memory-to-memory (non-register) 
Load register (memory-to-register) 
Register^to-regiater 
Register-to-mem ory 
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The MOV instruction may also be used to compare a memory location to zero. 
For example, 

MOV ifl 
JNE TEST 

moves Workspace Register 7 to itself and compares the contents of Workspace 
Register 7 to zero. If the contents are not equal to zero, the equal status bit is 
reset and control transfers to TEST. 

As another example of the use of MOV, assume that Workspace Register 9 
contains >3416 and location ONES contains >FFFF. Then 

MOV @aNES»9 

changes the contents of Workspace Register 9 to >FFFF, while the contents of 
location ONE^S is not changed. For this example, the logical greater than status 
bit is set and the arithmetic greater than and equal status bits are reset. 
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Op-code; DOOO (Format I) 

%iiiax definition: 

, L<iabel>] b MOVB b Cgas),(gad) b [<comment>] 

Example: " = 

NEXT olilO^ ^. ■ »^:%)t2A)41 ^oreft the meat significant byte of 

^ ' Wt^rkBpace Regis^^ 3 in address >2A41« 

Definition: 

Replaces the dettlncilSon operertd (byte) with « copy of the source operand (byte). 
If ^ther opiBS-a^ 4s addr^s^ in the Workspasd R^t^til'' i>i^ the I^C#' ' - 
addressed Is the most significant byte. The Iea»t Mgnificant byte is not affected. 
The computer compares the destination operand to zero and sets/resets the status 
bits to indicate the result of the comparison. The odd parity bit is set when the 
bits in the destination operand establish odd parity. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, and odd parity. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 13 
i L>IA>IE:QIC lOVICPIX j---- I INT, M^SK~I 

* A * M 

(gas) => (gad) 

Application notes: 

The MOVB instruction moves bytes in the same combinations as the MDV 
instruction moves words. For examf^e, if memory immUm >1C14 contains a 
^Hie of >20I6 and TEMP is located at >1C15, and if Worlcspace Register 3 
contains >542B, the instruction 

MOVB (iTEMP,3 

changes the contend Wctlcspaeie Regl^s^ 3 to >li^3. The logM ft^Gid^ 
than, arithmetic greater than, and odd parity status bits are set. While the m\iml 
status bit is reset. 
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X0.6 STORE STATUS— STST 
Op-codes <rarmat VIU) 

Syntax dBfiniUam 

[<label>] b STST b (wa) b [<connment>] 
Example: 

LABEL STST 7 Stores status in Workspace Register 7. 

Definition: 

Stores the Status Register contents in the specitied Workspace He^ster« 

Status bits affected: 
None. 

0 1 2 3 4 5 6 7 a 9 10 XI 12 13 14 15 
I L>IA>IEQ1C lOVICPlX I — 1 INT, MKSK i 

Execution resultst 
(ST) a> (wa) 

Application notes: 

The STST instruction stores the Status Register in the specified Workspace 
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10.7 STORE WORKSPACE POINTER— STWP 

Op-code: 02AO (Format VIII) 
Syntax definitions 

[<Iabel>] b STWP b (wa) b [<comment>] 
Example: 

LABEL STWP 6 Stores the Workapace Pointer in Workspace 

Register 6. 

Definition: 

Places a copy of the Workspace P^olntm' contents in the specified Wo^spaee 
Register. 

Status bits affected: 
None. 

0123456789 10 11 12 13 14 15 
1 L>IA>IeQ1C IOVIOPIX I---- 1 INT. WSK~ i 

ExeisuUon results: 
(WP) => (wa) 

Application notes: 

The STWP Instruction stores the contents of the Workapace Pointer in the 
specified Workspace Register. 
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Op-code: 06C0 (Format VI) 
Syntax definition; 

[<label>] b SWPB b (gas) b [<comment>] 
Example: 

SWITCH SWPB 3 Switchs the most significant and least significant 

bytes in Workspace Register 3. 



Definitions 

Re^lnees ^ mtOlt stgiMeant byte (bits 0-7} of the source operand with a copy of 
the ieast significant byte (bits 8-15) of the source operand and replaces the least 
significant byte with a copy of the most significant byte. 

Stc^B bits af feetedt 
None. 

■ 012345678 9 10 11 12 13 14 15 



|L>|A>|EQlC IQV OPIX [--■ 1 INT. M^^SK 



Execution results: 

Exchanges left and right bytes of word (gas). 

Application rKite« 

Use the SWPB instruction to interchange bytes of an operand prior to ©Xecuting 
various byte instructions. For example, if Workspace Register 0 contains >2144 
and memory location >2144 contains the value >r3l2, the instruction 



SWPB 



changes the contents of memory location >2144 to >i2F3 and increments 
Workspace Register 0 to >2146. The Status Register is unchanged. 
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10-9 INSTRUCTION EXAMPLE 

The foHowing program seqmmtl illustrates the use of many of the instruGtlons 
discuss^ in aee^<5fl. Tim ^ h-tt^SMtiidftli m m pt^im of a program that 

calls a subroutine labeled SUBR. The callir^ pr©^aim performs some initialization 
and then calls the subroutine to check the contents of a 20-byte buffer. If the 
subroutine finds that the buffer contains byte values that are in numerically 
sequential order, tftm it mtmm to €he eaUIng ps^am in Workspace Regist^* 4* 
If the bytes are not in numerically sequential ordef , th$ iKjbmKyne retens in 
Workspace Register 4. The program and subroutine are described in greater detail 
after the program is listed. 



LWPI 


>AC20 


Load Wcffkspacer Pointer. 


BL 


^UBR 


OaU subroutine 


DATA 


BUFFER 


Address of BUFFER. 


MOV 


4,4 


See if numbers are in sequence. 


JNE 


NOSEQ 


Jump if subroutine found non-sequential 






numbers. 



SUBR S 4,4 Clear Workspace Register 4. 

LI 10,20 Put loop count in Workspace Register 10. 

MOV *ll+,7 Put address of BUFFER in Workspace Register 7. 

MOVB «7,6 Put first number In the left byte of Workspace 

Register 6. 

CHECK MOV *7+,8 Put two bytes in Workspace Register 8. 

SB 6,8 Check for sequence. 

JNE OUT Jump if out of sequence. 

AI 6,>100 Add one to sequence checker. 

SWF^ 8 Put othm? byte in left half of register. 

SB 6,8 Check for sequence, 

JNE OUT Jump if out of sequence. 

AI 6,>100 Add one to sequence checker. 

DECT 10 Oa^ajmeiit lof^ uminter. 

3GT CHECK Jump to eheok next two hy^m. 

J MP RETURN Through checking, all in orders 

OUT INC 4 Set Workspace Register 4 to a non-zero vaUie. 

RETURN B *11 Return to calling program. 
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In ^tm GB^Ijig (arOj^^^n^ the LIMI instruction places a zero in the interrupt mask af 
the Status Register to turn off all maskable interrupts before loading the Work^acfe 
Pointer with the LWPI instruction and calling the subroutine. 

Hie BL instruc^Qi) l^^tr^ers progrttfi eontrol to the subroutine with the address 
following the BL trntrueHen plft^ Waartiapaee Register II to eUow foF return to 
the program. The location foilowing the BL instruction contains the address of the 
20-byte buffer to be checked by the subroutine. The subroutine returns control to 
the MOV inatruction in the calling program, which then checks to see if the 
subroutine found the bytes in numerically sequential order and jumps to teetlon 
NOSEO (not shown) if they were not. 

The subroutine clears Workspace Register 4 with the S instruction and puts a loop 
counter value of 20 in Workspace Register 10 with the LI instruction. 

Since Workspace Register 11 contains the address of the location following the BL 
instruction in the calling program, the MOV *ll+,7 Instruction copies the address of 
BUFFER into Workspace Register 7 and increments the address in Workspace Register 
11 to the location following the DATA directive, setting the address to the MOV 
instruction for the return when the subroutine is finished. The MOVB *7,6 instruction 
copies the first byte value into the left byte of Workspace Register 6. 

At label CHECK, the MOV instruction begins a loop that copies a word (two bytes) 
into Workspace Register 8 and auto-increments the address in Workspace Register 7 
to the next word in the buffer. The left byte of Workspace Register 8 is subtracted 
fmm its right byto* A non-zero nnylt indtcettfs an out of sec|uence number tand the 
JNE induction transfns control to the inatruction labeled OUT which places a >01 in 
Workspace Regietar 4* 

If the subtraction produces a zero result, the INC 6 instruction increments the 
contents of Workspace Register 6 to the next l^te to be c^mcked. The following 
SWPB inetfueton tkm in Workspace Register 8 so the following ^ and 
JNE instructions can check the sequence. If the sequence is correct, the next INC 
instruction updates Workspace Register 6 to the address of the next byte. 

The DECrr instruction decrements the loop counter in Workspace Register 10 by two 
dnce two t^ti^ have been checked. If the result is non-zero, t^re we more bytes 

to be checked and the JGT instruction causes a reiteration of the: Ifxip* If 1^ re^lt 
is zero, all 20 bytes have been checked and the JMP instruction causes a jump to the 
subroutine's exit at RETURN, There the B *11 instruction causes a return to the 
calling program. 
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ACTION 11: LOGICAL INSTRUCTIOI^ 



■ 



* 



The following logiced in^ruetione iom ^^^mtbmd in thk ^^iaru 



Instruction 
AND Immediate 
OR Immediate 
Exclusive OR 

jmm 

CLeaR 

SET to One 



Mnemonic 



Section 



Set Ones Corresponding 

Set Ones Corresponding, Byte 

Set Zotos Ccvresponding 

Set iC^HK^^eapondingy^ Byte 



INV 

CLR 
SETO 
SOC 
SOCB 

szc 



ANDI 
ORI 



11.1 
11.2 
12.3 
11.4 
H.5 
11.6 
11.7 
11.6 
11.9 
11,10 



Logical instructions permit you to perfornn various logical operations on memory 
locations and/or Workspace Registers. - ■" ■ ' ' ' 

Each Instruction consists of the foiISowing information. 

• A heading, consisting of the instruction name and mnemonic name 

• The op-code 

m The definition of the instruction . J" 

• The status bits affected 
ft The execution results 

ft Application notes when appropriate 

The op-code is a four-digit hexadecimal number which corresponds to «i ina^m^ion 
word whose address fields contain zeros. 



-I 
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The ayntax definition follows the conventions described in Seqtiqn 5, The generic 
names used in the syntax definitions are: 



gas ^tv^^l ^^e&t of t\m Swc^e oF>erand 

gad G^^al Adcfaress of tt\e Destination operand 

wa Workspace register Address 

iop Immediate OPerand 

wad Workspace register Address Destination 

disp DISPlaeemBnt of GI%J lines from the CRU bme register 

exp Expression thtt m^resents an instruction location 

cnt CouNT of bits for CR.U transfer 

sent Shift Count 

xop number of extended Operation 

Source statements that contain machine instructions can use the label field* the 
operation field, the operand field, and the comment field* 



Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
aetefire^ %etee aasemMlng a ttiachlne In^t^uetioti- 

The operation (op-code) field contains the mnemonic operation code of the 
instruction. The contents of the operand field are defined for each instruction. 

Inclusidn of fhw ccHfitnent fi^d is aiiidcmal. If used, it may Gonta^n any ASCII 
characters, including blanks. The tiomment has no effect on the assembly process 
other than being printed in the listing. 



In the execution results, the following conventions are used. 

( ) Indicates "the contents of." 

=> Indicates "replaces." 

* * Indicates "the absolute value of," 



The generic names used in the syntax definitions are also used in the execution 
results. 
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11.1 AND IMMEDIATE-ANDI 

Op-code: CS40 rormat VlII) 
Syntax definition: 

[<label>] b ANDI b (wa),(iop) b [<comment>] 
Example: 

LABEL ANDI 3,>FFF0 Sets least significant 4 bits of Wprkspace 

Register 3 to zeros. 

Definitions 

P^rfdrmB a blMvy^t^ AND operation on the 16 bits in the immediate operand and 
the corresponding bits of the Workspace Register. The immediate operand is the 
word in memory immediately following the instruction word. Place the result in 
the Workspace Register. The computer compares the result to zero and 
seWtM^^ «U^ft b$l8 ms&m^ '^ WttB t^n^t» &f the compm'ison. 

Status bits affected: 

Loigical greater thant arithmetic greater than, and equal. 

0123456789 10 11 12 13 14 15 
| L>iA>lEQiC iOVIQPiX 1-^- — --I INT. M<\SI<"| 

£!xecution resultiii 

(wa) AND iop => (wa) 
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AppUmMon notes: 

The AND! instruction performs a logical AND with an immediate operand and a 
Workspace Register, Each bit of the 16-bit word of both operands follows the 
foLlowing table. 



Immediate Workspace AND 
Operand Bit Register Bit Result 
ODD 

0 10 

1 a 0 
111 



For example, if Workspace Register 0 contains >D2ABf thft instruction 
ANDI 0,>6DO3 

results in Workspace Register 0 changing to >4003. This AND operation on a 
bit-by-bit basis is 

0110 1101 oQoo mu iivmmmm &pm«n^0€m) 

Uii 0010 1010 lOll (Workspace Register 0-D2AB) 



QlOO OOOQ OQOO 00X1 (Workspace Register 0 result~4003) 

In £Ms mmmpl»f th» logfeoii {^eater than and arithmetic greater than status bits 
are set» while the equal status bit is reset. 
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11.2 OR IMMEDIATE—ORI 

Op-code: 0260 (Format VIII) 
Syntax definition: 

[<label>] b ORI b (wa),(ipp) b [<comment>] 
Example: 

LABEL ORI 3,>RHJ0 Sets the most significant 4 bits of Workspace 

Register 3 to ones. 

Definition: 

Performs a logical OR operation orf. «Nd imm^i^ sdpArauid msdMm . 

corresponding bits of the Workspace Register. The immediate operand is the 
memory word immediately following the ORI instruction. Place the result in the 
Workspace Register. The computer compares the result to zero and sets/resets 
the status bits to indicate the result of the compartofu 

Status bits affected: 

Logical greater than, arithmetic greater ttiani MOSi equal* 

0 1 2 3 4 6 7 8 9 10 11 12 13 14 15 
l L>iA>|£QlC lOVlQPJX i -1 INT. IWVSK I 

A 

Exeeution results: 

(wa) OR Clop) => (wa) 
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Application notes: 

The ORI instruction performs a logical OR with the immediate operand and a 
specified Workspace Register. Each bit of the 16-bit word of both operands 



Immediate Workspace ORI 
Operand Bit Register Bit Result 
Q 0 Q 

10 1 
Oil 
111 



For exampis, if Workspace Register 5 contains >02AB, the instruction 
ORI 5;>^3 

results in Workspace Register 3 changing to >FFAB. This OR operation on a 
bit-by-bit basis is 

0110 1101 0000 0011 (Immediate operand-->6D03) 
1101 0010 1010 1011 (Workspace Register 5->D2AB) 



nU lUX 1010 1011 (Workspace Register 5 re8ult-->FFAB) 

In this example, the logical greater than status bit is set, and the arithmetic 
greater than and equal status bit are reset. 
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IX^ EXCLUSIVE im-XOR 

Op-code: 2800 (Format III) 
Syntax definition: 

[<iabei>] b XOR b (gas),(wad) b [<comnnent>3 
Example; 

LABEL XOR @WORD,3 Exclusive ORs the contents of WORD and 

Workspace Register 3. 

Definition: 

Performs a bit-by^it exduaave OR of the source ml <te»«^tiift^on cipeimvdSi md 
replaces ^ destination upc^raraj with the result. The ei^luslve OR is 

* accomplished by setting the bits in the resultant destination operand to one when 
the corresponding bits of the two operands are not equal. The bits in the 
resultant destination operand are reset to zero when the corresponding bits of the 
two operands are equal. The computer compares the resultant destination 
operand to zero and sets/resets the status bits to indicate the result of tlie 
comparison. 

Status bits affected: 

Logical greater than, arithmetic greater than, and equal. 

0 1 2 3 4 5 6 7 8 9 XO 11 12 13 14 15 
| L>|A>1EQ|C lOVlQPlX I---- ---I INT, IvASK I 

■AAA 

Execution results: 

(gas) XOR (wied) »> CvM) 
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Application notes: 

The XOR instruction performs an exclusive OR on two word operands. Each bit 
of the 16-bit word of both operands follows the following table. 



Immediate Workspace XOR 
Operand Bit Register Bit Result 
0 0 0 

Oil 
10 1 
110 



for example, if Workspace Register 2 contains >D2AA and location CHANGE 
contains the value >6D03, the instruction 

XOR @change:»2 

results in the contents of Workspace Register 2 changing to >BFA9. Location 
CHANCE immains >6D03. This is shown as feOlows. 

0110 1101 0000 0011 (Source operand— >6D03) 
1101 0010 1010 1010 (Destination operand->D2AA) 



1011 1111 1010 1001 (Destination operand re3ult~>BFA9) 

In this example, the logical greater ^tmB ^tafyiS bit is set, while the arithmetic 
greater than and equal status bits are reset. 
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11.4 UtlVERT— INV 

Op-code: 0540 (Format VI) 
Syntax definition: 



[<Iabel>] b INV b (gas) b [<comment>] 
Exsmplet 

COMPL INV @BUFF(2) Replaces the value at the address found by 

adding the value of Workspace Register 2 to the 
contents of BUFF with the one's complement of 
the data. 



Definition! 

Replaces the source operand with the one's complement of the source operand. 
The one's complement is equivalent to changing each zero in the source operand 
to one and each one in the source operand to zero. The computer compares the 
result to zero and seta/r^iets the fttatus bits to indicate the result of the 
comparison. 

Status bits affected: 

Logical greater than, arithmetic greater than, and equal. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
i L>lA>lEQ|C lOVlQPlX 1 1 INT. NnSK I 

« w » 

Execution results: 

The one's complement of (gas) Is placed in (gas). 
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The INV instruction changes each zero in the source operand to one and each one 
to zevo* For example, if Workspace Register 11 contains >157A, the instruction 

INV XI 

changes the contents of Workspace Register 11 to >EA85. This INV operation on 
a bit-by-bit basis is 

0001 0101 0111 1010 (Workspace Register 11-->137A) 
1110 1010 1000 0101 (Workspace Register 11 re8uit->eAd5) 

The logical greater than status bit is set and the arithmetic greater than and 
equal status bits are reset. 
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U«5 CLEAR— CLR 

Op-code: 04C0 (Format VI) 
Syntax definition: 

[<label>] b CLR b Cgas) b [<comment>] 
Examples 

PRELM CLR @BUFF(2y' Clears the value at the address found by adding 

the value of Workspace Register 2 to the 
contents of BUFF, ' - • 

Definition: 

Replaces the source operand with a full 16-bit word of zeros. 

Status bits affected: 
None, 

0 1 2 3 A 5 6 7 8 9 10 11 12 13 14 15 

l L>|A>lEQiC lOVIOPIX I I INT. M^SK~ 1 



Execution results: 
0 => (gas) 

Application notes: 

The CLR instruction sets a fuU» 16-4>tt, memc^-addressable word to zero. For 
example, If Worlcspace Registra- 11 contains the value >2001y the instruction 

CLR ♦>B 

results in the contents of memory iacatians >2000 and >2001 being set to 0* 
Workspace f^gistMr 11 and the Status Register are unchan^d. Word (Operations, 
such as CLR, operate on the next lower address when an odd address Is given as 
the operand. 
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11.6 SET TO ONE-^SETO 
Op-codes 0700 (Format VI) 

Syntax definition: 

[<iabel>3 b SETO b (gas) b E<commBnt>] 
Example: 

LABEL SETO 3 AS&ts WcSfcfe^ce Regfetftr 3 to SffFF or 



Definition: 

Replaces the source operand witii a full 16-btt word of ones. 



None^ 



0 1 2 3 4 5 6 7 a 9 10 11 12 13 14 15 
L>1A>1EQ|C iOVIOPlX 1 INT. mSK I 



Execution results; 
>FFFF => <gas> 

Application notes: 

The SETO instruction initializes an addressable memory to a value of ndgfilttve 1. 
For example, the instruction 

SETO 3 

initializes Workspace Register 3 to a value of >FfFF, The contents of the Status 
Register ere unchanged. This is a useful means of setting flag words. 
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11,7 SET ONES CORRESPONDING— SOC 

Op-code: EOOO (Format I) 
Syntax definition: 

[<label>3 b SOC b (gas),(gad) b [<comment>] 

Example: 

LABEL SOC 3,2 ORs Workspace Register 3 into Workspace 

Register 2. 



Definition: 

Sets to one the bl^ in the destine^dn operand that co^espond to the one bits in 
the source operand. Leaves unchanged the bits in the destination operand that 
are in the same bit positions as the zero bits in the source operand. This 
operation is an OR of the two operands. The changed destination operand 

replaces ^ otl^inal deAlUMon optitrand. The eomiput^ i^mp^^ the result to 
zero and sets/resets the status bits to indicate the reKiIt the comparison. 



Status bits affected: 

Logical greater than, arithmetic greater than, and equal. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l L>iA>lEQlC iQVlOPIX 1---- 1 INT. M\SP<~I 

A> * M 

Execution results: 

The bits of (gad) that correspond to the bits of Cgas) that are equal to 1 are set 
to 1. 
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rm WC CDfl« ^ i^^Mt &im%mt^ ^ two operands. For example, If 

Workspace ReglstOT 3 contains >F1F'D0 snd location NEW ccHitains >AAAA, the 
instruction 



changes the contents of location NEW to >FFAA, while the contents of Workapace 
Kegistor 3 are unchanged. This SOC operation on a bit-by-bit basis is 

1111 1111 0000 0000 (Source operand->FFaO) 
1010 1010 1010 1010 (Deatinatlon operand->AAAA) 



1X11 1111 1010 10X0 (Oestinatioii c^and result-^fFAA) 

In this example, the logical greater than status bit is set and the arithmetic 
greater than and equal status bits are resets 
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11.8 SET ONES CORRESPONDING, BYTE-SOCB 

Op-code: FOOD (Format I) - 
Syntax definition: 

[<label>] b SOCB b Cgas),(gad) b [<comment>] 
Exampte 

LABEL SOCB 3,@DET ORs Workspace Register 3 into' the byte at 

location DET. 

Definition: 

Sets to one the bits in the destination operand that correspond to the one bits in 

the source operand byte. Leaves unchanged the bits In, thii detitUctation operand 
that are in the same bit positions as the zero bits in the source opramd byte. 
This operation is an OR of the two operand bytes. The changed destination 
operand byte replaces the original destination operand byte. The computer 
compos the resulting destination operand byte to zero and sets/resets the status 
bits to indicate the results of the comparison. The odd parity status bit is set 
when the bits in the resulting byte establish odd parity. 



Status bits affected; 

Logical greater than, arithmetic greater than, equal, and odd li^aHty* 

0 I 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>1A>|EQ|C lOVTOPiX 1 1 INT. WSK | 

* A A A 

Execution results: 

The bits of (gad) that correspond to the bits of (gas) that are equal to 1 are set 
to 1. 
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Register 5 contains >F0X3 and Workspace Register 8 contains ttie vfilue >AA24, 
the irmtruction 

SOCB 3,8 

changes the contents of Workspace Register 8 to >FA24, while the contents of 
Workspace Register 5 are unchanged. This SOCB operation on a bit-by-bit basis 
is 

1111 0000 0001 mi {BmmB operand-^roi^) 
IQIO 1010 0010 0100 (DestlnaUon operand^>AA24) 



1111 1010 0010 0100 (Destination operand result— >FA24) 




In this example, the logical greater than status bit is set, while the arithmetic 
greater than, equal, and odd parity status bits are reset. 
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X1.9 :@£p^ CORRESPONDING-^O 

Op-code: 4000 (F ormat I) 
Syntax definition: 

[<label>] b 5ZC b (gas),(9ad) b [<comipent>] 

Example; 

LABEL SZC @MASK,2 Resets the bits of Worl«Bpiffi# Bisgister 2 as 

indicated by MASK. 

Definition: 

Seta to zero the 'in the destination operand ^at cmteqpbVid to the &ft 
positions equal to one in the source operand. This operation is effectively an 
AND operation of the destinaUon op^and and the one's complement of the source 

operand. The computer compares the resulting destination operand to zero and 
sets/reseta the status bits to indicate the results of the comparison. 

Status bits affected: 

Logical ^eater .than, arithmetic greater than, and equal. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>|A>|EQ|C iOVlOPiX I -■-] IfMT. N»5K~| 

AAA 

Execution results: 

The bits of (gad) that correspond to the bits of (gas) that are equal to 1 are set 
to 0. 
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The SZC instruction turns off flag bits or ANDs the destination operand. For 
example, if Workspace Register 5 contains >6D03 and Workspace Register 3 
contains >D2AA, the instruction 

SZC 5,3 

changes the contents of Workspace Register 3 to >92A8, while the contents of 
Workspace Register 3 remain unchanged. This 5CZ operation on a bit-by-bit 
basis is 

0110 1101 0000 0011 (Source operand->6D03) 
1101 0010 1010 1010 (Destination q>erand->D2AA) 



1001 0010 1010 1000 (Destination operand result— >92A8) 

In this exannple, the logical greater than status ^jlt is set, while the arithmetic 
greater than and equal statu? bits, are reset. 



LOGICAL INSTRUCTIONS 



lUXQ SET ZEROS CORRESPONDING, BYTE— SZCB 

Op-codd: 5000 (Format I) 
Syntax definitions 

[<label>3 b SZCB b (gas),(gad) b [<comment>] 

LABEL SZCB g|MASK,@CHAR Resets the bits of CHAR as 

indicated by MASK. 

Definitions 

to th»JMI^^ «he des^nkttoh ^pkidM^^'^t^itai^^ to the bit 
positions equal to one in the source operand byte. This operation is effectively 
an AND operation of the destination operand byte and the one's complement of 
the source operand byte. The computer compares the resulting destination 
operation to zero and sets/roeeta the ^tus biU to indiettte tiie roM^'of the 
oomiMrlson. The odd pafhif status bit Is set when the bits in the resulting 
destination operand byte establish odd parity. When the destination operand is 
given as a Workq)ace Register, the most significant byte is the one affected. 

Status bits affected; 

Logiottl greater than, arithmetle greater than, equal, and odd part^. 

D 1 2 3 4 5 6 7 8 9 10 11 12 1? 14 15 
| L>TA>|EQ|C IQVIOPIX I 1 INT, fvV\SK I 



Execution results: 

The bits of (gad) that correspond to the bits of (gas) that are equal to 1 are set 
to 0. 
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The Instruction is used for the same applications as 5ZC except that bytes 

are used instead of words. For example, if location BITS contains the value 
>FQ18 and location TESTVA contains the value >AA24, the instruction 

SZCB ©BITS^TESTVJI 

changes the cont«»^{^ ^ TESTVA to >£)A24y while BITS retnQin? unqha^ed. This 
U shovi^n as .. • 

1111 mo max lOOO (source □p«afid-*«>rm8} 
1010 1010 0010 0100 (Desttnatioin Q|ieiF«»i^-<iv^ 



. QQQQ 1010 0010 OIGO (Destinatic^ :Qp^9|ii|,j«9yll^->0A24) 



(Unchanged) 

In this example, iMse>^l33teil^greate^%ha(3<^®9lGtl greater ata<i;u8^it8 

are set, whUe #1^ parity statMS b|ts are raset. 



. : • ■ ■ 11 
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SECTION 12s WORKSPACE REGISTER SHIFT INSTRUCTIONS 



The following Workspace Register #ftl^ ift^uctions are deseribe^ frit sectioru 

Mnemonic Section 

SRA 12.1 

SRL 12.2 

SLA 12.3 

SRC 12.4 

An example is given in Section 12.5. 

Workspace RgigN^ sW lr^iie£Sonjap«eYnft you t& shift the ojontents of a specified 
Workspace Register from one to 16 bits. For each of these instructions, if the shift 
count in the instruction is zero, the shift count is taken from Workspace Register 0, 
bits 12 through 15. If the four bits of Workspace Register 0 are equal to zero, the 
shift count is 16 bit positioha. The Value of the last bit ^li'^sd out of Ito Workspace 
Ref£^«»< is placed in the carry bit of the Status mQU/tsm, Th# result ia compared to 
zero, and the results of the comparison are shown in the iogif^ greater than, 
arithmetic greater than, and equal bits in the Status Register. If a shift count 
greater than 15 is supplied, the Assembler fills in the four-bit field with the least 
significant four bits of the shift count. 

Each instruction consists of the following information. 

0 A heading, consisting of the instruction name and mnemonic name 

o The op-code 

0 Th9 syntax definition 

o An eximipla of thei tn^rtiction 

0 The definition of the instruction 

o The status bits affected 

0 The execution results 

o Ap|3tl^eatto notes Wh^ appropriate 

The op^code la a four-digit hexadecimal number which corresponds to an instruction 
word whose address fields contain zeros. 



Instruction 

Shift Right Arithmetic 

mft Lm mmmeitic 

Shift Ridit Circular 
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Tim lynlax «l8finitien l^illows the convwH^bm diseribed In Saction 5. Tho gmiN^lc 
names used in Uie syntnc definittons araz 

gas General Address of the Source operand 

gad General Address of the Destination operand 

wa Worlaiiaca regirtir AddTBSB 

iop immaffi^ OParand 

wad Workspace register Address Destination 

disp Displacement of CRU lines from the CRU base register 

exp Expression that represents an instruction location 

sent Shift Count 

xop numbar of aXtandad OParation 

Source statements that contain machine instructions can use the label field, the 
opwation flaldy the operand field, and the comment field. 

Use of the label field is optional. When it is used, the label is assigned the address 
of the instruction. The Assembler advances to the location of a word boundary (even 
address) before assembling a machine instruction. 

The opaniion Cof»-eode) field contains the mnamonlB operation code of the 
instruction. The contents of the opmnd field are defined for each instmptlon^ 

Inclusion of the comment field is optional. If used, it may contain any ASCII 
characters, including blanks. The comment has no effect on the assembly process 
other Uisn being printed In the listing* 

In the execution resuitSp the following conventions are used. 

( ) Indicates "the contents of.'* 

>> Indicates '■replaces." 

« * Indicates "the abscdute value of." 

The generic names used in the syntax definitions are alao used in the execution 
results. 
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WORKSPACE REGISTER SHIFT INSTRUCT IQI^ 



12a SHIFT RIGHT ARITHMETIC— SRA 

Op-code; 0800 (Format V) 
Syntax definition; 

[<label>] b SRA b (wa),(scnt) b [<comment>] 
Exannpler 

LABEL SRA 2,3 Shifts Workspace Register 2 right 3 bit 

locations. 

Dft^nittons 

Shifts Ihe e^ntu»H« ^ tha aj^lfied Work8pad# R^flstev feo ther i^t f£H^ the 
specified number of bit positions. Fills vacated bit positions with the sign bit. 

Status bits affected: 

Logical greater thsn, aritfntietle greater than, equal, and carry. 

01234567 8 9 10 11 12 13 14 15 



L>|A>1EQC lOVlOPlX I - I INT. IvVXSK I 



Execution results: 

Shifts the bits of (wa) to the right, extending the sign bit to fili vacated bit 
positions. When sent is greater than 0, shifts the number of bit positions 
specified by sent. If sent is equal to 0, the numb^ of bit poE^tldns 
contained in the four least significant bits of Workspace Register 0. If sent and 
the four least significant bits of WOTkspace Register 0 both contain Os, shifts 16 
positions. 
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Aj^lication notes: 

The SRA instruction shifts the given Workspace Register to the right the given 
number of bit positions and fills vacated positions with the sign bit. If 
Workspace Regis^ 5 eqitfl^ns ttin vakid >$^f and WorMpace Rfl^ar 0 
contains the value >r326y the Instruction 

SRA 5,0 

changes the contents of Workspace Register 5 to >FE08. This SRA operation on 
a bit-by-bit basis is 



The logical greater than and carry status bits are set, while the arithmetic greater 
than and equal status bits are reset. 



XOOO 0010 0010 0100 



nil 0011 0010 Olio 



(Workspace Register 0— >F326 Four least 
significant bits are 0110, so shift 6 positions) 
(Workspace Register 5— >8224) 



1111 UlO 0000 1000 



(Workspace Register 5 result— >FE08) 
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12.2 SHIFT RIGHT LOGICAL— SRL 

Op-Gode: 0900 (Format V) 
Syntax definition: 

C<label>] b SRL b (wa),(scnt) b [<comment>] 

Example: 

LABEL SRL 2,7 Shifte Workspace Register 2 right 7 bit 

locations. 

Definition: 

Shifte ^ eorimts of the ^lecl^ed Work^^e Register to the right the spedfied 
number of bits. Fills the vacated bit positions with zeros. 



Status bits affected: 

Logical greater than, arithmetio greater than, equal, and carry. 

7 8 9 10 11 12 13 14 15 



1L>|A>|e:Q|C IQVIQPIX I INfT. NnSK I 



Execution results: 

Shifts the bits of (wa) to the right, filling the vacated bit positions with zeros. 
If sent is greater than 0, flhtffcs the number of bit positions specified by sent. If 
sent it equ^ to 0, shifts the number of bit paritioni eolits^nad in the four least 

significant bits of Workspace Register 0, If sent and the four least significant 
bits of Workspace Register 0 both contain Os, shifts 16 bit positions. 
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Aj^Ucation notes: 

The SRL instruction shifts the given Workspace Register to the right the given 
number of bit positions and fills vacated positions with zeros. If Workspace 
Register zero contains the value >FFEFy the instruction 

SRL 0^ 

changes the contents of Workspace Register 0 to >1FFD. This SRL operation on 

a bit-by-bit basis is 

Ull 1111 1110 1111 (Wcrkspace Regtater 0->FFEF) 



0001 Ull 1111 1101 CWorkspace Regiater 0 re8ult->UT0) 

The logical greater than, arithmetic greater than and carry status bits are set, 
while the equal status bit is reset. 
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12.3 SHIFT LEFT ARITHMETIC— SLA 

Syntax definitions 

[<label>] b SLA b (wa),(scnt) b [<comnnent>] 
Examples 

LABEL SLA 2,1 Shifts Workspace Register 2 left 1 bit location. 

Definition: 

Sliifts the contents of the specified Wc»>k8pace Register to the left the specified 
number of bit piaBll;ion8. Fills the vacated bit positions with zeros. Note that 
the overflow status bit is set when the sign of the word changes during the shift 
operation. The carry status bit contains the value shifted out of bit position 
zero. 

Status bits affectedt 

Logical greater than, arithmetic greater than, equal, carry, and overflow. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| L>IA>1EQ1C 1C3V10PIX I I INT. W\fKSK~\ 

» > Jt * )» 

Exeeutimi resultst 

Mfts the bits of (wa) to the left, ^llng the vacsatsd bit portttans iji^th zeros. 
When sent is greater than 0, shifts the number of bit positions specified by sent. 
If sent is equal to 0, shifts the number of bit positions contained in the four least 
significant bits of Workspace Register 0. If sent and the four least significant 
bits of Workspace Register 0 both contain Qs, shifts 16 bit positions. 
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Application notes; 

The SLA instruction shifts the given Workspace Register to the left the given 
number of bit positions and fills vacated positions with zeros. If Workspace 
Register 10 contains the value >1337, the instruction 

SLA 10,3 

changes the contents of Workspace Register 10 to >6AE0. This SLA operation on 
a bit-by-bit basis is 

0001 0011 0101 0111 (Workspace Register 10->1357} 



0110 1010 1110 0000 (Workspace Register 10 result-->6A£Q) 

The logical greater than, ^ithnrietlc greater than, and overflow status bits are 
seti while the equ0. ind ean^ sitatus bits aF& feset. Refer to Section, X2r5 
anothOT example. 
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12*4 SHIFT RIGHT CIRCULAR-SRC 

Op-code: OBOD (Format V) 
Syntax definitioni 

i;;<labBl>] b SRC b (wa),C8cnt) b [<comnr»ent>] 
Example: 

LABEL SRC 746-3 Shifts Workspace Register 7 circularly 3 bit 

locations right. 

Definition: 

Shifts the specified Workspace Register to the ri^t the specified number of bit 
|pl»4MorKSt* Fi^ Vtfcated bit positions with the bit shifted out of position 15. The 
carry status bit contains the value shifted out of bit position zero. 

Status bits affected: 

Logical greater than, arithmetic greater than, equal, and carry. 

0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| L>|A>1EQ|C IQVIOPjX I I INT. M'^SK"! 



Execution results: 

Shifts the bits of (wa) to the right, filling the vacated bit positions with the bits 
shifted out at the right. If sent is greater thtth Q> ^if ts the number of bit 
positions specified fa^ simt. If sent to SH^ucd to 0, ts the number of bit 
positions contained in the four least significant bits of Workspace Register 0. If 
sent and the four least significant bits of Workspace Register 0 both contain Os, 
shifts 16 bit positions. 
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Application notes: 

The SRC instruction shifts the given Workspace Register to the right the given 
number of bit positions and fills vacated positons with the bits shifted. If 
WOTkspace Registw 2 enn&BiiNt tN» vatOto >**ft>'v Itmm^tiim 

SRC 2,7 

changes the contents of Workspace Register 2 to >DFFF, This SRC operation on 
a bit-by-bit basis is 

nil 1111 1110 nil (Workspace Register 2->FFEF) 



1101 nil nil nil (Workspace Register 2 result->[DFFF) 

The logical greatw lhan and cairy status bits are seti while the arithmetic 
greater than and equal status bits me reset. 

There is no "shift left circular" instruction because the same effect can be 
obtained with SRC. To shift left a number of bits, instead shift right by a 
number equal to 16 minus the number. For example, to shift left 7 bits, shift 
right by 16 minus 7 or 9 bits. 
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12.5 INSTOUCTION EXAMPLE 

This shift instruction shifts the indicated Workspace Register a specified numb^ of 
bits to the left. F*or example instruction 

SUA 5,1 

shifts the contents of Workspace Register five one bit to the left. The carry status 
bit contains the value shifted out of bit position zero. The ium$ IniBi^iimtMm JOC 
and permit you to test IHe ted bit. Tf^ d^erflttw j^tus bit is adi wtw the 
sign of the contents of the Wo^kipaee Register being shifted changes during the shift 
operation. If Workspace Register 5 contains 

aw mi mm im 

before the dhift, the instruction changes Workspace Register 5 to 

1001 1110 0001 1110 

The carry status bit contains a zero and the overflow status bit is set because the 
contents changed from positive to negative (bit zero changaEl: ^om B to 1). If this 

shift sign change is significant, you could insert a JNO inStTUOtlon to test the 
overflow condition. If there is no overflow, control transfer* to the normal program 
sequence. Otherwise, the next instruction is executed. 
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It is fjossible to construct double-length ^ifte the SLA instruction, im shift two 
or more w^ds in a Workspace. The following code shifts two consecutive Workspace 
Registers assuming thati 

□ The contents of Workspace Registers 1 and 2 are shifted one bit position. 

o Additional code could be included to execute the codfs. oRce for each bit shift 
required, when shifts of more than one bit position are required. The 
additional code must include a means of testing that the desired number of 
Shifts are performed. 

o Additional code tests for overflow frum Workspace Register 1, to branch to an 
error routine at location ERR when overflow occurs. 



SLA 
JOC 

JNC 
INC 



1,1 
ERR 



EXIT 
1 



Shift m one tit. 
Transfer if no carry. 
Transfer bit from R2 to Rl, 



Shift Rl one bit. 



EXIT 



INC 



X 



Continue with program. 



ERR 



NOP 
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SEfTTKIN »t PSEUDO-U^^TiaiCTIQNS 



A pseudo-instruction the form of a r^elSffiB bittructton but its unusutU 
charaeteritf^kSft lk» not allow it to be a machU» li^^t»^Qn^ 'prcp^ ctefinition. Each 
pseudo-instruction serves a unique purpose. The Assembler includes two 
pseudo-instructiqns which are discussed below. 



13.1 NO OPERATION— NOP 
Syntax definitom 

[<label>] b NOP b [<comment>] 

NOP places a machine Iftiitru^Qn In the object code wMch only effeeta mcemil^on 
time of the progranu Use of the tabal field is optional* When the label field is 
usedy the label is assigned the location of the instruction. The operation field 
contains NOP. The operand field is not used. Use of the comment field is optional. 

Entttr the NOP pseudo-instructions as shown in the following example. 
MOD NOP 

Location MOD contains a NOP pseudo-instruction when the program is loaded. 
Another instruction may be placed in location MOD during execution to implement a 
piroparn option. The Assembim* supplies the same object code as though the source 
statement contained the following code. 

MOD JMP $+2 



Instruction 
No operation 
ReTurn 



Mnwnonic 
NOP 



Section 

13.1 

13.2 
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i:j.2 return— RT 

Syi$^3^ (leMtion: 

[<label>] b RT b [<comment>3 

RT places a machine instruction in the object code to return control from a 
subrou^ne ter a leajyOng routine. Ltee of the lab^ HpU Is -optional. When the label 
field ift used, the label is assigned the location of the instruction. Tftn ^@|iSa^$(ioin field 
contains RT. The c^erand field is not used. Use of the commit fleid is o|t^onsl« 

Enter the RT pseudo-instruction as shown in the following example. 

RT 

The Assembler supplies the same object code as though the source statennmit 
contained the following code. 

B *U 

When control is transferred to a subroutine by execution of a BL instruction, the link 
to the calling routine is stored in Workspace Register 11. An RT pseudo-instruction 
returns program control to the instruction following the BL instruction in the calling 
routine. 

See Section 24.11 for more information. 
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You can do much to affect the assembly process tJy placing awfembler diteGtives In 
yciur source code. With these directives, you can 

• Alter the Location Counter, 
.Change A98eml;»I^ ou^put^, 

• Initialize constants. 

• Provide linkage befcw«i^ pro-ams. 

• Define extended ope^s^irm mv^.. Wid inrograms. 

These classes of directives are discussed in this section in the order listed. 
Each directive consists of the following infcnrmation. 

• The directive name and mnemonic name. 

• The syntax definition, foUov/ing the conventions described, in Sectijon 5» 

• An exannple of the directive. 

• Ifm c^initLon of ths ^^eeMva* 

■ Application notes when appropriate. 



In Assembler directives, use of the label field is optional. When a label is used, it is 
assigned the address of the directive. , Inclusion of the comment field is also 
optional. If used, it may contain any ASCII characters, including blanks. Tine 
comment has no effect on the ammbly process other than being printed in the 
listing. 
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14.1 Dlt^CTlVES THAT AFFECT THE LOCATIPrsi Cf^Umm 

As the Assembler reads the source statements of a program, a component of the 
Assembler, ciall&d f-i^ Location Cotinli^* afi^aoees feo BCttr^itOW^ to to rswrt^py 
locations assigned to the resuUing object €ode. l^he firfft ^ve msm^Wt ^^^fM 
discussed in this section (AORG, RORG, DORG, BSS, and BES) initialize the Lci^tlcin 
Counter and set up blocks of code, allowing you to place code at the location in 
memory where it will operate most efficiently when there are special memory 
requirements. RORG also forces object code to be relocatable so that the computer 
can place it where, it is mo^t'effici^n^* EVENi places the Location Counter at an 
even word boundary. 



PSEG and PEND are standard conditions, so they are not ordinarily used. With 
another loader, which allowed the use of CSEG, CEND, DSEG and DEND, they would 



Loader provided are shown .^elc^Wr 



:ion Counter, and ave useable With the 



Directive 


Mnemonic 


Section 


Absolute GRiGin 


AORG 


14.1.1 


Relocatable ORiGin 


RORG 


1A.L2 


Dummy ORlGin 


DORG ,. 




Block Starting with Symbol 


BSS 


' 14.1.4 


Block Ending with Symbol 


BES 


14.1.5 


Word boundary 


EVEN 


14.1.6 


Program SEGment 


PSEG 


14.1.7 


pogrom segment END 


PEND 


14.1.8 



Other directives, for setting up various kinds of segments, are also availeble for use 
with a loader which you provide. They are discussed in detail so that you may write 
a loader which uses them. They are not acceptable to the Loader provided. The 
dire^lvet yiiat.affeot the Mo^l|Giln^<lm$||^^M are niat useable with the Loader 
provided are shoyw belqw. 



Directive 

Common SEGment 
Common segma^t END 
Data^Gmiif!^ 
Data seaiMt END 



Mnemonic 

CSEG 

CEND 




ftJ - nr.;. 



> r 



Section 
14.1.9 
14.1.10 
14*1.11 
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Absolute Origin— AORG 

Syntax definition: 

[<label>] b AORG b <wd-e)^. |> t<c^imfi)^J 
Example: 

UW^ AOF^ >GO0O-i-X If X has a value of 6, the LocaUon Counter is 

adt to >C006. LABEL is assigned the value 
>C006- 

Definition: 

Places a vsilue In the Loeattan Gmtum wnA dMnas the following lot^tivs^a as 
absolute, enabling you to ispeclfy the exact locations iri which dt^^oel 10 
loaded. If a label is used, it is assigned the value that the directive lift 
the Location Counter. If you do not include an AORG directive in your program, 
the object code contains no absolute addresses. 



14.1.2 Relocatable OHgin-^ORG 

Syntax definition: 

[<label>] b RORG b [<exp>] b C<comment>] 
Examples 

LABEL RORG $-20 Overlays 10 words. The $ symbol refers to the 

location following the preceding relocatable 
NiQi^tiiifT Bf the program* Thte e@c»F^le bsHSkg up 
the Location Counter 10 words. LABEL is 
assigned the value placed in the Location 
Counter. 

[definition: 

Places a value in the Location Counter which, if encountered in absolute code, 
also defines succeeding locations as program-relocatable. If a label is used, it is 
assigned the value that the directive places into the Location Counter. The 
operation field contains RORG, and the operand field is optional. The comment 
field can be used only when the operiuid field k useid. 



EDITOR/ASSEMBLER 

Page 210 



ASSEMBLER DIRECTIVES 



If the operand field is not used, the length of the program segment, data 
segment, or specific common segment of a program replaces the value of the 
Location Counter, For a given relocation type X, the length of the X-relocati^le 
9e9ment is zero if m program-'relocatable code has been previously assembliKl* 
Otherwise, it is the maximum value of the Location Counter due to the assembly 
of any preceding block of X-relocatable code. 

Since the Location Counter begins at zero, the length of a segment and the "next 
available** addreia^ ^Mn that segment are Identical. 

If the RORG directive appears in absolute or relocatable code and the operand 
field is not used, the Location Counter value is replaced by the current length of 
the program segment of that program. If the directive appears in 
data-relocatable code without an operand, the Location Counter value is replaced 
by the len^ Qtf thiriEfata ae^dnt. Similarly, in common-relocatable code a 
RORG directive without an operand causes the length of the apim'opriate common 
segment to be loaded into the Location Counter. 

If the operand field is used, the operand must be an absolute or relocatable 
expresslbh <i^) dontainftvg jpSpevsaMy defined eyntbols. If the directive is in 
absolute code, a reloea^le dpei^ must rmt^ the eiffrent Location Count«^. 

If the RORG directive appears in absolute code, it changes the Location Counter 
to program-relocatable and replaces its value with the operand value. In 
relocatable code, the operand value replaces the current Location Counter value, 
and the relocation type of the Location Coiinter remains unchanged. 

Application notes: 

You may use the RORG directive to replace previous instructions and directives. 
This is the purpose of the example. Alternatively, the RORG directive can be 
used without an operand field. 

For example, suppose your program starts with statements defining data which 
occupies >44 bytes, followed by an AORG directive, a BSS directive, statements 
in a block, and a BES directive to end the block. Then the directive 

SEG2 RORG 

places >0044 in the Location Counter and defines the Location Counter as 
relocatable. The symbol SEG2 is given a relocatable value of >0044. The RORG 
directive, as used here, has no effect except at the end of an absolute block or a 
dummy bloc^ 
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14.1.3 Dummy C^igiii— OORG 

[<label>] b DORG b <e9q>> b [<comment>] 

Example: 

LABEL DPRG 0 Cause* Ihs Awmb ter to assign values to the 

laboftt wSHilfi the dummy section reiative to the 
start of the dummy section. 

Definition; 

Places a value in the Loi»tUm Coun^ mnd di^nrVAs the following address kKSSit^ons 
as a dummy block or section. When assembling « duRMfiy «e^on> ttm Assemble 

does not generate object code but operates normally in all other respects. The 
result is that the symbols that describe the layout of the dummy section are 
available to the Assembler during assembly of the remainder of the program. 
The label is assigned the value that the directive places in the Location Cottfittf. 
The opei^nd field contains an expression which may be either absolute or 
r«loi^iEta&te. Ar^ jS9!mbol in the expression mint have been previously defined. If 
the operand is absolute, the Location Counter contents are absolute. If the 
operand is relocatable, the Location Counter contents are relocatable. 



14.1.4 Block Stwting ^th Symbol— BSS 

Syntax definition: 

[<label>] b b <wd-ffiK^ b [<ecrtiimen&] 
Examples 

BUFFI BSS 80 Reserves a 80-byte buffer at location BUFFI. 

BUFFI is set equal to the previous value of &m 
Location Counter. 

Definition: 

Advances the Location Counter by the value of the well-defined expression in the 
operand field. If a label is used, it Is assigned the value of the location of the 
flvBt byte in the block. 
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AppllcatitSn rioted 

The B5S directive is used to start a block. Blocks are used to set up areas of 
code that you wish to have loaded into specific memory locations; for example, to 
set up a reference table. The AORG directive must precede the BSS directive, 

14.1.5 Block Endl^ with Symboi— BES 

Syntax definition: 

[<iabel>] b BES b <wd-exp> b [<comment>] 
Example: 

BUFF2 BES >10 Reserves a buff^« If the Location 

Counter contains >100 when the Assembles' 
processes this cKrftctive, BUFF^ |s assigned the 
value >110. 

Definition 

Advances the Location Counter acccwding to the value of the wiE^*^fined 
»>^e8sion in the Operand field. If a label is Ineltidof^ thd ^r^tivm m$^^*s the 
new Location Counter value to the symbol in the label field. The BES directive 
marks the end of a block started with the BSS directive. 



14.1.6 Word Boundary— EVEN 

Syntax definition: 

[<labd>l b Wmm b [<i^meftt»3 
Example: 

WRFl EVEN Assigns the Location Counter address to label WRFl and 

ensures that the Location Counter contains a word boundary 
address. 

Definition: 

Places the Location Counter on the next word boundary (even) byte address. If 
the Location Counter is already on a word boundary, the Location Counter is not 



EDITOR/ ASSEMBLER 

Page 213 



A^Ma,Elt DIRECTIVES 



altered. If a label is used, the value in the Location Counter is assigned to the 
label before proceiifllad the ^^tivfu Ttie qp^r^ct fieidl mnok us^d. 

Application notes: 

The EVEN directive etmm» Ih^ &m pee^imim U at an dven urord bountey when a 
atdtement that consists of only a Itibei Is preceded by a TEXT or BYTE directive 
and is followed by a DATA directive or a machine instruction. In this case, the 
label does not have the same value as a label in the following instruction unless 
the TEXT or BYTE directive left the Location Counter on an even (word) 
location. 

Using an EVEN directive before or after a machine instruction or a DATA 
directive is redundant since the Assembler automatically advances the Location 
Counter to an even address when it processes a machine instruction or a DATA 
directive. 

X4.1.7 Program Sagmant— PSEG 

Syntax definitionx 

C<label>] b PSIIG b C<cQmmBnt>] 

Example: 

LABEL PSEG 

DefinlU^ 

Places a value in the Location Counter and defines successive locations as 
program-relocatable. If a label is used, it is assigned the value that the 
directive places in the Location Counter, The value placed in the Location 
CmtOmF as a rasull 11^ ^pmeUm U warn If -no program-relocatable code has 
been pqraviaui^ MmanMini^ Otlier«d«l^ it is Uttf mximunn value tha Location 
Counter has attalaed as a result of the assembly of any preceding block of 
pro^m-relocatabia aode* 

• 

AppUedieft m^m 

Tha PSBXSt dte^tiva only rvpefiitt the daf^Ult mode« if you are using anothw 
loacter that also accepts the CSEG^ CEND, DSCG, and DENO directives, when the 
PSEG directive Is useful. 
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I4.1.6 Program ^f^roi^ End>»oPEND 

Syntax definition: 

[<label>] b PEND b [<cofnment>] 

Example: 

LABEL PEND 

Definition! 

Places a ymhm In tim LomUon Coarser and de^nes the foikiwing Ifacatliortt aa 
program-relocatable. If a label is used, it is assigned the value of the Location 
Counter prior to modification. The value placed in the Location Counter by this 
directive is the maximum value ever attained by the Location Counter as a result 
of the as8emt»^ of 0 pec^Y^; pi^em-reiocatebie code. If the PEND 
ditatti^t^ le emmmtmmi dat^caleieiEtat^ or common-relocatable It 
functions as a DEND or CEND and a warning messafe ie issued. Like D£ND and 
CEND, PEND is invalid if used in absolute code. 

Application notes; 

The PEND directive only repeats the defeftjlt mode. If you are using another 

loader that also accepts the CSEG, CEND, DSEG, and DEND directives, then the 
PEND directive is useful. The PEND directive is provided as the 
program-segment counterpart to the DEND and CEND directives. However, since 
PEND properly appears only in program-relocatable code, the relocation type of 
successive locations remains unchanged. 



14.1.9 Common Segment—CSEG 

The C^G directive is not accepted by the Loader provided with the 
Editor/Assembler. 

Syntax definitions 

[<lab*] b |( I5€eomment>l 
Example; 

COMl CSEG 
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Definition: 

If you provide an appropriate loader, CSEG places a value in the Location 
Counter and defines successive locations as common-relocatable (i.e.y relocatalifo 
with respect to a commoii «iB^iuitit)» If m label is used, it id assi^ied the value 
that the direcUve places in the Loration Cdnntor* 

The CSEG directive defines the beginning (or continuation) of the "blank common" 
segment of the program. 

ApplicaUon notstt 

The CSEG directive is not accepted by the Loader provided v/ith the 
Editor/Assembler. The CEND, PSEG, DSEG, AORG, and END directives all 
terminate the definition of a blocl< of common-relocatable code. The block is 
normally ter^htelfid a CCMD .diroelStop^ Like CEND, th»J%SBlv4Mtlve 
iiK^eMes tint sueooiilrar^lati^fltts iatav^pragram-celocsatable. The E^EO'tiHt 
AORG directives effectively terminate the common segment by beginning a data 
segment or absolute segment. The END directive terminates the. comn^. 
segment as well as the program. j 

14.1*10 Ornimon'Sagmwit . 

The CEND directive is not accepted by the Loader provided with the 

Editor/ Assembler. 

Syntax definitiom i 

[<label>] b CEND b [<comment>] 
Example: 

LABEL CEND 

Definition: 

If you provide an appropriate loader, CEND terminates the definition of a block 
of common-relocatable cods by pAac^ng a vatue in th» Loca^on Counter and 

defining successive locations as program -relocatable. If a label is used, it is 
assigned the value of the Location Counter prior to modification. The value 
placed in the Location Counter as a result of this directive is zero if no 
program-relocatable code has been previously assembled. Otherwise, it is the 
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maximum value the Location Counter has attained as a result of the assembly of 
any preceding block of program-relocatable code. 

AppUcaUan notes: 

The CEND directive is not accepted by the Loader provided with the 
Editor/Assembler. If the directive is encountered in common-relocatable or 
program-relocatable code, it functions as a DEND or PEND directive and a 
warning message is issued. Like DEND and PEND, CEND is invaUd if it is used 
in absolute code. 



14.1.11 Data Segment— DSCG 

The tfSE^ i&ecttve is not accepted by the Lpadar provided with the 
editor/Assembler* 

Syntax definition: 

[<iabei>] b DSEG b [<comment>] 

Example: 

LABEL DSEG 

Definition: 

If you provide an apptoftf late loader, DSEG places a value In the Location 

Counter and defines successive locations as data-relocatable. If a label is used, 
it is assigned the data-relocatable value that the directive places in the Location 
Counter. The value placed in the Location Counter as a result of this directive 
is zero if no program-relocatable code has been previously assembled. Otherwise, 
it is the maximum value the Location Counter has attained as a result of the 
as8emt>iy of any preceding block of program-relocatable code. 

The DSEG directive defines the beginning of a block of data-relocatable code. 
The block is normally terminated with a DEND directive. If several such blocks 
appear throughout the program, thi^ ^emprise the data se^^ni of thoi progi«m. 
The er^ire «tota segment can bef relocMiKed Ittdte p enidftitly of Vtm ptrcpgram segment 
when the programs are linked and therefore provides a convenient means of 
separating modifiable data from executable code. 
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Application notes; 

The DSEG directive is not accepted by the Loader provided with the 
Editor/Asaembler. In addition to the DEND directive, the PSEG, CSEG, AORG, 
aiid WHO dfaro^ves properly terminate the definition of a block of 
data-relocata^ edde. Like DEh4D, the PSEG directive indicates that succesdve 
locations are program-relocatable. The CSEG and AORG directives effectively 
terminate the data segment by beginning a common segment or absolute segment^ 
respectively. The END directive terminates the data segment as well as the 
program* 

The follov^ng example Ulustrates the use of both the {36EQ and the DEND 
directives. 

RAM DSEG Start of data area. 



* Data-relocatable code. 



ERAM DEND 

LRAM EQU ERAM-RAM 

The block of code between the DSEG and DEND directives is data-relocatable. 

RAM is the symbolic address of the first word of this block. ERAM is the 
data-relocatable byte address of the location following the code blodc The value 
of the symbol LRAM is the length of the block in bytes. 
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Data Sagmant Emlt-PEM) 

The DEND directive is not accepted by the Loader provided with the 
Editer/AaBembtetK 

Synfe«« 4»f loHiom . ^ <• . . ir„ . 

[<labol>l h DEND b [<comment>] 

Examples 

LABEL DEND 

Definition: 

If you provida an appropriate laadsr, DEND tarminiifeM &m dafinition of a block 
of dat»«aloeataiMB code by placing a. value in tJtm tjoeaOmJ^^m^ and; daiiNng 
successive locations as program-relocatable. If a label is used, it is assigned the 
value of the Location Counter prior to modification. The value placed in the 
Location Counter as a result of this directive is zero if no program-relocatable 
code has been previously aaaambled. Othorwlsey it is the maximum valtie tha 
Location Countar has aver attalnad as a raault of the wmmMf of any procading 
block of program-ralocatabia coda. 

Application notes: 

The DEND directive is not accepted by the Loader provided with the 
Edltor/Aaianiblar. If tha diracUva la ancountarad in commcai-ratocatabla or 
pffOgVam-raiooatable code. It functions as a CEND or PEND and a warning 
message to tottiad. Uka CEND and PEND» DEND ia invaUd if mad in abaoUtta 
code. 
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14^2 DIRECTIVES THAT AFFECT ASSEMBt^R OUTPUT 



In order to make Assembler output as easy to read as possible, you may specify a 
variety of mtput fiMto foe die Assembler. These optiot^ ii^llli^ yfiimlm W Uil M> 
source code, where to put pageSf the page title to btt ctsed, and the pctif^ffl £i|hi^i^^ 
to be used. In addition, aeveral options are available when you select the Assembler. 
Refer to Section 2 for more details on the other output optiorau The directives that 
affect Assembler output are shown below. 

Directive Mnemonic Section 

No source ttet UNL IA.2.1 



14.2.1 No Source List— UNL 

Syntax definition: 

C<iabel>] b UNL b [<eomment>] 

Example: 

LABEL UNL 

Definition: 

Stops printing of the source listing. The UNL directive is not printed in the 
source listing, but the line counter is incremented. If a label is used, the current 
value of the Location Counter Is assigned to the labeL The comment field is 
optional, but the A^^mlate does not prbit tite &mmBm^ Thf» UNL. ac^ LIST 
directives have no effect unless you have selected ari tm^>Ut dlQVloe and the L 
option has been selected. See Section 2 for more informaUon. 

Apptitation notes: 

The UNL directive ^ops the printing and thus reduces assembly time, as well as 
the size of the soiree lisUng. 



LIST source 
PAGE eject 
Page TITLe 



Program IDenTifier 



LIST 
PAGE 
TITL 
IDT 



14.2.2 
14.2.3 
14.2.4 
X4,2.5 
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14.2.2 List SouTCS—LIST 

^fumx definitiom 

[<label>] b LIST b [<comment>] 
Examplej 

LABEL LIST 
Definition! 

Restarts printing of the source listing. This directive is required only if you 
previously gave a No Source List (UNL) directive to cancel listing. The directive 
is not printed in the source listing, but the line counter is incremented. If a 
label is used, the current value of the Location Counter is assigned to the label. 
The comment field Is optional, but the AiffiemMer does not print the comment. 
The UNL and LIST directives have no effect unless you have selected an output 
device and the L option has been selected. See Section 2 for more information. 

Syntasi definition: 

[<label>] b PAGE b [<comment>] 
Example: 

LABEL PAGE 
D#fiiiltlQI?(! 

Causes the Assembler to G@nft$mie the source program listing on a mm page. The 
PAGE directive is not printed in the source listing, but the line counter is 
inOTemented. If a label is used, the current value of the Location Counter is 
assigned to the label. Use of the comment field is optional, but the Assembler 
does not print the comment. 
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Appiication notes: 

The PAGE directive causes the Assembler to begin a new page of the source 
listing. The next source statement is the first statement listed on the new page. 
XJm of the page directive to begin new pages of the source listing at the logical 
divisions of the program improves documentation of the p^ocfFam. 

14.2.4 Page Title—TITL 

Syntax definition: 

C<label>] b TITL b »<string>' b [<commBnt>] 
Example: 

LABEL TITL '•REPORT GENERATOR** Cauaee the tlMe *REPORT 

GENERATOR* to be printed in 
the subsequent page headings of 
the source listing. 

Deftnitlont 

Supplies a title to be printed in the heading of the source listing. The directive 
is not printed in the source listing. If a label is used, the current value of the 
Location Counter is assigned to the label. The operand field contains the title as 
& atHng of up to 50 characters enclosed in single quotes. If you enter more than 
50 characters, the AsfiemMer retains the first 30 characters aa the title and 
prints the message OUT OF RANGE. The Awembler does not ^int a comment 
included with the directive, but does increment the line counter. 

To include a title in the heading of the first page of the source listing, a TITL 
directive must be the first source statement in your po^gram* Then the title h 
printed on all pages until another TITL directive ia (:^ocesBed^ If the TITLE 

directive is not the first source statement, the title is printed on the next page 
after the directive is processed and on subsequent pages until another TITL 
directive is processed. 



EDITOR/ ASSEMBLER 

Page 222 



ASSEMBLER DIRECTIVES 



14.Z.5 Program Identifier— IDT 

Syntax definition: 

[aat)el>3 b IDT b •<8tring>' b [<comment>] 
Example: 

LABEL IDT •OONVERT' Assigns the nastm CX3NVERT to 13ie program to 

be assembled. 

Definition: 

Assigns a name to the program. If you use the IDT directive, it should precede 
any machine instruction or assembler directive that results in object code. If a 
label is used, the current value of the Location Counter is assigned to the labeL 
The operand field conM^ the pro-am name ss a string of up to eight characters 

enclosed in single quotes. If more than eight characters are entered, the 
Assembler prints a truncation error message and retains the first eight characters 
as the program name. 

The program mmm Is printed in the sourde livUng ^ the opi^nd of the IDT 
directive but does not appear in the page heading of the source listing. The 
program name is placed in the object code but serves no purpose during the 

Assembly. 
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14.3 DIRECTIVES THAT INITIALIZE CONSTANTS 

You may define the values of constants and place values in bytes and words with 
directives. The directives that initialize constants are shown below. 

Directive Mnemonic Section 

Define assembly-time constant EQU 14.3.1 

Initialize BYTE BYTE 14.3.2 

Initialize word DATA 14.3*3 

Initialize TEXT TEXT 14.3.4 



14.3.1 Define Assembly-Time Constant— EQU 

Syntax definition: 

<label> b EQU b <exp> b i<comment>] 
Example: 

BUFFER EQU >100Q Assigns the value >1000 to BUFFER. 

Definition: 

Assigns a value to a symbol. The label field contains the symbol. The operand 
field contains an expression in which all symbols have been previously defined. If 
a symbol is used in the operand field, and that symbol appears In the label field 
of a machine instruction in a relocatable block of the program, the value is 
relocatable. After the execution of this directive, the symbol in the label field 
and the value or symbol in the operand field may be used interchangeably. 
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14.3.2 InitiaUze Byte—BYTE 



Syntax definition; 



[Oab^] b BYTE b <mtMf^^>%^ ^ l<eQfmmentO] 



Example: 



KONS 



BYTE >F+1,-1,0/AB'-'AA' 



Initializes four bytmt atetlng with 
the byte at location KONS. The 
contents of the resulting bytes are 
>10, >FF, >00, and >01. 



DeMtiem 

Places one or more values in one or more successive bytes of memory. If 0 label 
is used, the location at which the Assemblw placee the fU^ liyte is assigned to 
the label. The operand field contains one or more expressions separated by 
commas. The expressions must contain no external references. The Assembler 
evaluates each expression and places the value in a byte as an eight-bit twd's 
complemfent^hmtter. If %inlh^lfon te t#^ubed, the Assembler prints a truncation 
error message and places the rightmost portion of the value in the byte. The 
EVEN directive is commonly used after the TEXT directive to insure that the 
next instruction starts on an even word boundary. 

14.3.3 Initialize Word— DATA 

Syntax definition; 



[<label>] b DATA b <exp>[y<e3q^]». b 



C<cO]iim^t>3 



Example: 



KONSl 



DATA 3200,1+'AB',-'AF','A' 



Initializes four words, starting on a 
word boundary at location KONSI. 
The Gontenta of the resulting words 
are >0C80, >4143, >BEBA, and 



>0041. 
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Definition: 

Places one or more values in one or more successive words of memory. 1 he 
Assembler automatically advances the Location Counter to a word boundary 
(evert) adtdre^ If miMm^f am pUmt >0Q ia IN byt^ ^dptjeEt. if a kbel \$ uaed, 
the location at which the Assembler places the first word is assigned to the label. 
The operand field contains one or more expressions separated by commas- The 
Assembler evaluates each expression and places the value in a word as a 16-bit 
two's complement number. 



14.5.4 Initialize Text— TEXT 

Syntax definition; 

[<label>] b TEXT b I-J<atPtFii>' b [<l2«imtneiit>] 
Example; 

M5G1 TEXT 'EXAMPLE' Places the seven ASCII hexadecimal 

representations of l;he characters in EXAMPL^E 
in successive bytes. If the L^esmtidn Counter Is 

on an even address, the result is >A558, >414D, 
>5D4C, and >45XX where XX is determined by 
the next source statement. The label MSGl is 
assigned the value of the first byte address. 

Definition: 

Places one or more characters in successive bytes of memory. The Assembler 
negates the last character of the string if the string is preceded by a unary minus 
(-) sign. If a label is used, the location at which the Assembler places the first 
character is aligned to the label. The ©jserand field contains a character string 
of ^ %& 52 c|i«8»l®r% wMoh CM h6 preceded H m&W f^O^S #grv The EVEN 
directive is commonljf im^d after the TEXT directive to insure that the next 
instruction starts on aft even word boundary. 
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14.4 DIRECTIVES THAT LINK PROGRAMS 

It is often convenient to write programs as separate modules which can be linked 
together. Several directives allow you to rfo so. The"DtF antf KEF'^reetive^ atllow 
ydli td |3lii&e SfSe or more symbols defined in a module into the object code, maldng 
them available for Unking, The COPY directive allows you to have the AssemblOT 
copy a file from a diskette and include it In the assembly process. 

The LOAD and SREF c^ctlvea assemble properly bi^t Bte not used by the Loader 
provided* They are discussed in detail so that you may write a loader which uses 

them. With an appropriate loader, different from the one provided, the LOAD and 
SREF directives allow you to place in the object code symbols used in the module but 
defined in another module, so that they can be linked. The directives that link 
programs are shown below. 



Directive 


Mnemonic 


Section 


External DEFinition 


DEF 


14.4.1 


External REFerence 


REF 


14.4.2 


COPY 


COPY 


14.4.3 


Force LOAD 


LOAD 


14.4.4 


SecondaBy REFerence 


SREF 


14.4.5 



14.4.1 External Definition— DEF 
Syntax definition: 

[<label>] b DEF b <symbol>[,<symbol>]... b [<commBnt>] 
^cample: 

LABEL DEF ENTR,ANS Causes the Assembler to include symbols 

and ANS in the object code so that these 
symbols are available to other programs. 
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Definiticjni 

Makes one or more symbols available to other programs for reference. If a label 
is used, the current value of the Location Counter is assigned to the label. The 
operanct fJeitJ contains more symbols, separated by commas, feo foa ^flmii 

in the program being ^»BrfifeI®d. TH© DEF dip^tiwie fm ^ feyinijel mm% pitm^& 
the source statements that contain the symbols, or the Assembler identifies the 
symbols as having been defined more than once and issues a duplicate definition 
warning message. 

A^lie«dh rvotess 

Labels that have been defined vj'ith the DEF directive are entered into the 
REF/DEF table and maintained in the REE/DEF table like other symbols defined 
by the DEF statement. Labels defined with the RET statement are resolved at 
loading time and removed fom the REF/DEF table. 

Duplitmte definitians are accepted by the Loader, with the most recent definition 
being used. A warning message is issued when duplicate definitions are given. 

Syntax definition: 

[<label>] b REF b <symbol>[,<8ymbol>] ... b [<comment>] 
Examples 

LABEL REF ARG1,ARG2 Causes the Assembler to include symbols ARGl 

and ARG2 in the object code so that the 
corresponding addresses may be ob.tained from 
other programs. 

Definition: 

Provides access to one or more symbols defined in other programs. If a label is 
used, the current value of the Location Counter is assigned to the label. The 
Operand field jDontate tmw m mom ayfvM^ separate by comrms, to be ua^ in 
tti© operand field of a subsequent source statement. 
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If a ^mboA to lIMed in Ihe RET sia£0mn£, a 6c»3e«s^m^ti@ ^isMSdl must be 
present in a DEF statement in another source j:|i0^Ie. If a one-to-one matching 
of symbols does not occur, the error code >0D Is given when the progp'am is 
executed. 

If a sym^oi k\ the operand of a ^0=* ^sB^iv» h f^U ^^and &f a 
DATA directive, the Assembler places the value of the symbol at location 0 of 
the routine. If that routine is loaded at absolute location 0, the symbol is not 
linked correctly. Use of the symbol at other locations is correctly linked. 

14.4.3 Copy File-COPY 

Syntax definition; 

[<tebel>l b ODPY b "<fUe name>" b 
Example: 

LABEL COPY "DSKl.MAIN" Copies the file MAIN from the diskette in 

Disk Drive 1 for inclusion in the assembly 
process. 

Definition: 

Includes a file from a diskette in the assembly process. When the AsaembJl.ar 
encounters this directive, it copies the file from the dMetfeiS and continues WlClK 
the fi^sembiy process as if the file were in the program aclual^ be^ ai^McMtd. 

You can include as many COPY directives as you wish in a program. Note, 
however, that when an END directive is encountered in any file, including those 
being copied, the Assembler stops the assembly process. 

Application notes: 

The COPY directive allows you to write programs as separate modules which can 
be linked together. This may be done for writing convenience or because the 
program is too large to fit in one file. 
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The following is a sample program which uses the COPY directive. When it is 
assembled, the Assembler first assembles the file named MAIN on Disk Drive 1, 
fdUowed by the files PROG and DATA, also on Disk Otim 1. th^ l^e fe^ of 
the imgrtm ia assembied. The object file crested includes all of the assembled 
files. The END statement tells the Assembler to stop assembling. 



14.4.3.1 Using the COPY Directive In the Game 

In addition to the SAVE utility (See Section 24.5), the Editor/Assembler diskette 
labnled Part B contains a game or application program which uses the COPY 
directive. 

The owner's manual for the the game or application program you received is included 
with your Editor/Assembler. You can also use your Disk Manager Command Module 
to catalog the diskette to find which game you received. The instructions below 
relate specificaUy to game Tombstone City, but they apply generally to whichever 
game or application program you received. 

TOMBS is the main module, consisting mostly of COPY directives. When it is 
assembled, the COPY directives copy the rest of the program files, which are 
TOMBA, mmm, tomc^ romm, TdM^, anrf TOMBF** the program Is token 
into these portions because of its lengths 

Because the source listing, TOMB, is already on the diskette, the game may be played 
without further assembly. However, if you wish to assemble the file in order to see 
the processf fk^ Insert' tto ell^ette whi^ n^nt^im t'he A^mbler Cl^lsleled P^t A) in 
Mm I ani #i30se the ^^EMSLE option on the Editor/ Assembler. Then insert 
the diskette (labeled Part B) that contains the game in Disk Drive 1 and give the 
source file name as DSK1.TOMB5 and the object file as DSKl.TOMB. If you have an 
RS232 Interface unit and an RS232-compatible printer, give the list file as RS232 and 



COPY 
COPY 



"DSKl.MAIN" 
"DSKl.PROG" 
'•DSKLDATA" 



END 
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options as LRSC. Yoy ©armfc lim to idiskefel© feecause the file is too large. If you 
do not have an RS232 Intiefface unit, do not give a lUt file and assemble with options 
RC. 

To run the program, select the LOAD AND RUN option on the Editor/ Assembler. 
The file name is DSKl.TOMB. The ppogmm en^ wtth the END START directive, ao 
it begins running as soon as it is loaded. Alternatively, ym msq^ run the game from 
TI BASIC by running the following program: 

100 CALL LOADC'DSKLTOvB") 

Yoti. ins^ ata alt^ the game so that it may be used with the RUN PROGRAM FILE 
option on the Edit or/ Assembler selection list. See Section 24.5 for instructions. 

14*4.4 Force Load—LOAD 

The LOAD directive is not accepted by the Loader provided with the 
Editor/ Assembler. 

Syntax deflndtlora 

[<label>] b LOAD b <symbol>[,<symbol>]... b t<comment>] 

Example: 

LABEL LOAD SYMBOL 

Definition: 

If you provide an appropriate loader, the LOAD directive loads a symbol into the 
REF/DEF table for later resolution. The LOAD directive is similar to REF, 
except that the symbol does not need to be used in the module containing the 
LOAD directive. The symbol included in the LOAD directive must be defined 

the DEF direotSi^ in Acime &tSm module. The LOAD directive is used 
together with the SREF directive. If a one-tO-one matching of LOAD-SREF pairs 
and DEF symbols does not occur, urvesolved references occur during linking. 
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14^4.5 Scicondary External Reference— SR.EF 

The SREF directive is not accepted by the Loader provided with the 

Syntax eJetinitloni 

[<label>] b SREF b <symbol>,[<symboI>]„. b [<connment>] 
Examples 

LABEL SREF ARG1,ARG2 Includes symbols ARGl and ARG2 in the object 

code so that the corresponding addresses may be 
obtained from other programs. 

Definition: 

If you provide an appropriate loader, SREF provides access to one or more 
symbols defined in other programs. If a label is used, the current vakiR of the 
Location Counter is assigned to the label. The operand field contains one or 
more symbols, separated by commas, t0 be used 111 ttie operand field ef a 
subsequent source statement. 

Application notes: 

The SREF directive is not accepted by the Loader provided vi/ith the 
Editor/Assembler. SREF, unlike REF, does not require that a symbol have S 
ocH»P»apomilng ayrt^sol ll^ed in a DEF statement of another source mtidtfle* 
However, without a corresponding symbol, the symbol in the SREF directive is an 
unresolved reference- 
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14.5 MISCELLANEOUS DIRECTIVES 



You may use the DXOP directive to define extended operations for use with the XOP 
instruction, which is only available on the TI-99/4A Home Computer. The END 
directive signals the end of a program and, when used with a label, startB execution 
of a program as soon as it is loaded. The miscellaneous directives are shtWl 

Directive Mnemonic Section 

Define extended €)^«»^«)n 14#5.1 
Program END END 14.5.2 

14.5.1 Define Extended Operation—DXOP 

Syntax definition: 

[<label>] b DXOP b <symbol>,<term> b [<comment>] 



Example: 

LABEL DXOP DADD,1 Defines DADD as ^t^nded operation 1. When 

you include the syfnbol DADD in the operand 
field of an XOP instruction, the Assembler 
assembles an XOP instruction that specifies 
extended operatiUft 1* 



Definition: 

The DXOP directive is only useful on the TI-99/4A Home Computer. To find 
which extended operations your computer supports, see Section 7.19. If 
available, the DXOP directive asdgntt m ^mnEioi to be iised tn the operator Md to 
specify an extended operation. If a label is used, tha ourrent value in &^ 
Location Counte is assigned to the label. The operand field contains a symbol 
followed by a comma and a term. The symbol assigned to an extended operation 
must not be used in the label or operand field of any other statement. The 
Assembler assigns the symbol to an extended operation specified by the term, 
which has a value of 1 or 2. 
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14.5^ Program End—END 

Syntax definition: 

Caabel>] b END b [<symboI>] b C<comment>] 
Example: 

NAME END START Terminates the assembly of the program. The 

Assembler also places the value of START in the 
object code as an entry point. 

Definition: 

Terminates the assembly process. The last source statement of a program Is the 
END directive. Any source statements which follorw the END directive are 

ignored. If a label is used, the current value in the Location Counter iS assigned 
to the symbol. If the operand field is used, it contains a program-relocatable or 
absolute symbol that specifies the entry point of tlie program. The comment 
field may be used only when the operand field ia used. If the END statement has 
an operand, the program runs as soon as it is loaded, starting at the address of 
the operand. 

Application notes: 

If the END statement is omitted, the Assembler issues an END ASSUMED 
weiring meSsagi&t and I/O mtot >07 is displayed. However, this should not cause 
a problem in loading and running the program. 

If the operand field is not used, run the program by entering a program name 
when using the LOAD AND RUN option on the Editor/ Assembler selection list or 
the WKI.L LINK statemmtfc in TI BASIC. The program name must be an entry 
point defined in the DET instruction. 
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The major purpose of the assembly process is the production of objmst ^oite m tfmt 
fmr peo^m can be run by the c!@l^|Mtf£ltr; Thld^ lia^^^ hli^Clil&f «t description of the 
object c^ide im-oducied acr ^lat you can iidit It td make mihcyr ^cHttng^ Sn your program. 

In addition to object code, the Assembler prints a source listing and a sorted 3)^mbol 
table. You can affect the form of the listing by use of variow C^r^t^et ^s£si£^^ 
in Section In addition, the Assembler produces a list of fa^ and nonfafeal 

mmm The pk^jwrn of cdl of C»!^t Is lo iM9i^ to discover errors in your 
program so th^ you can, changing the ^em&i eode^ Kiid<d the paropriim mn 
correctly. 

15.1 SOURCE LISTING 

The source listing shows the source statements and where their resulting object code 
is placed in memory. However, for the string following a TEXT directive, only the 
ASCII code for the first character Is listed. A complete example is given in Section 
15.5. 

99/4 ASSEMBLER appears on the first line of each page. The second line contains 
VERSION 1.1 (or the version you are using), the title you supplied in a TITL 
directive, and the page number. 

Below this headir^ iiiateHalt the printer lists a line for each source statement 
containing the source statement number, the Location Counter value, the object code 
assembled (in hexadecimal notation), and the source statement as you entered it in 
your program. When a source statement generates more than one word of object 
code» the Assembler prints the Location County yahie and object for^ea£fi' 
8dditiJ»iAl word of ebjeot eocto on a separate Um foJlowing the mwtsB statement. An 
exarnple of tht: rnat^ial printed is 

QOia Q156 C820 MOV ©INIT+3,[§3 
Q158 0X2B> 
015A 0003 

The source statement number, 0018 in the example, is a four-digit decimal number. 
Source records are numbered in the order in which they are entered, whether or not 
they are listed. The TITL, LIST, UNL, and PAGE directives are not listed, and 
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source records between a UNL directive and a LIST directive are not listed. The 
difference between two printed source record numbers indicates how many source 
records are not listed. 

The next field contains the Location Counter value as a hexadecimal value. In the 
exampie, >0156 is the Location Counter value. Not all directives affect the Location 
Counter. If the directive does not affect the Location Counter, the field is left 
blank. Of the directives that the Assembler lists, the IDT, REF, DEP, DXOP, EQU, 
SREF^ LOAD, COPY, and ^rec^Waa leave the Location Counter field blank. 

The third fieid, >C820 in the example, contains the hexadecimal representation of the 
object code placed in the location by the Assembler, The apostrophe (') following the 
third field of the second line in the example indicates that the contents, >012B, are 
program-relocatable. A quote ("} In this lot^tion indicate that the loeattorf U 
data-relocatable, while a plus ^gn M Indiiiatefi th^ the labM is relocatable miWi 
respect to a common segment. All machine instructions and the BYTE, DATA, and 
TEXT directives use this field for object code. The EQU directive places the value 
corresponding to the label in the object code field. 

feniMi Mid <?ci«n1^n8 the first 60 characters of source statement as you wrote it. 

%Mlng In this a&rH Is determined by the spacing in the source statement. Thus, 
source statement fields are aligned in the listing only when they are aligned in the 
same character positions in the source statements. 

The mat^ina Infftrutstion used in the exarn|>la spFdcifles the symbolic memwy 
addraiidng tm^ for both oparand& This eausott the in^uetion to occupy three 

words of memory and three lines of the listing. The object code corresponds to the 
operands in the order in which they appear in the source statement. 

15.1.1 Error Meatagaa 

The Assembler processes fatal and nonfatal error messages. Fatal errors stop the 
assembly process with the appropriate error message displayed on the screen as 
shoM^ 
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SYMBOL TABLE OVERFLOW 
CANT GET COMMON 
CANT GET MEMORY 
DSR ERROR XXXX 



The XXXX field following DSR ERROR contains the first two bytes of the Peripheral 
Access Block which contain the error code. See Section 18.2 for more information. 

NCH^atal errcn^S init stop tfm wmf^kf pt^^^mm Instead, an error message is 
printed following the atateinerft OQt^i(in^ %fm et^m and is also displayed on the 
screen. Each error gives the type Of erPor and the number of the statement in which 
it occurred. 



Nonfatal Errors 

***** SYNTAX ERROR - nnnn 
***** INVALID REF - nnnn 

0UT W HANGE: - nnnn 
***** MULTIPLE S?/M®OLS - nnnn 
*♦»*» INVALiD MNEMONIC - nnnn 
**«*« BAD FWD REFERENCE - nnnn 
»»»»» INVALID TERM - nnnn 
***** INVALID REGISTER - nnnn 
***** SYMBOL TRUNCATION - nnnn 
***** UNDEFINED SYMBOL - nnnn 
***** COM TABLE OVERFLOW - nnnn 
***** pEND ASSUMED - nnnn 
»♦»** DEND ASSUMED - nnnn 
»♦»»* CEND ASSUMED - nnnn 
»*♦** END ASSUMED - nnnn 
***** COPY ERROR - nnnn 



If there are soiy undefined 8ynrtt)ol» in the asaemb^i ^ undefined symt>ols are listed 
m, m& mti ^ the Ustlng under the heading THE FOLLOWING SYMBOLS ARE 
UNDEFINED. 
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15.2 OBJECT CODE 

The Assembler produces object code that may be loaded directly into the computer. 
If it is not C0nipi-&ia^d, object &^0Mmi^s^ &f pmm^'G€^mMT^ 71 ASCII 
characters each. TW f&$w^ pit^rWi^^^Mction of minor errors by using the Editor 
to edit the object code. The file fOTrtiat is OI^LAY, FIXED 80, 

• ■ I. ■ < . 

The object code consists of variable-sized records. Each record consists of a number 
of character tags, each followed by up to two fields. Most fields are numeric and 
consist of four hexadecimal digits. The length of the character fields is described in 
the following sections on each of the tag characters* 

When the Assembler has no more data or the record is full, it writes the tag 
character 7, followed by the checksum field end the tag character F, which requires 
no fields. The Assembler then fills the rest of the record with blanks and a sequence 
number and then begins a new record With the appropriate tag character. The Im^ 
record of an object module ha« a colon (0 in thie fif9t character position of the 
record, followed by the identification cede 99/4 A5^ 

The tag characters used by the Assembler are 0, 1, 2, 3, 4, 5, 6, 7, 9, A, B, C, and F. 
You may substitute a tag character 8 for a tag character 7 in order to have the 
Loader Ignore the ohaiskfium. Tag chapitetB^ 1 iS 4^ored- Any other tag produce art 
error. 

Tag character 0 is used for program identification. Field 1 contains the number of 
bytes of program-relocatable code, and field 2 contains an eight-character program 
identifier assigned to the program by an IDT directive; When you do not include an 
IDT dipeo^v», thd deeond field coitt^ntf blanks. The Loader uses the program 
identifier to identify the program and the number of bytes of program-relocatable 
code to determine the load bias for the next module or program. The Assembler 
places a single tag character 0 at the beginning of each program. 

Tag characters 1 and 2 are employdd with entry addresses. Tag character 1 is used 
when the entry address is absolute. Tag character 2 is applicable when the entry 
address is relocatable. The field contains the entry address. One of these tags may 
appear at the end of the object code file. The Loader uses the field value to 
determine the entry point at which execution starts when the loading is complete. 
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Tag characters 3 and 4 are used for external references. Tag charactOT 3 Is used 
when the last appearance of the symbol in Field 2 of the tag is in 
program-relocatable code. Tag character 4 is employed when the last appearance of 
the symbol Is not in relocatable eacte^ Field 1 contains the Itscetlori of tStt km 
appearance of the symbol. The sIx-charactOT symbol in Field 2 is the external 
reference. For each external reference in a program, the object code contains a tag 
character with a location or an absolute zero and the symbol that is referenced. 
When Field 1 of the tag character contains absolute zero, no location in the program 
requires the address that corresponds to the reference. When Field 1 of the tag 
charac£ei! oo^talns a loe$£iis^ the 00t:imi OOtr^oMng to the reference is filaced in 
thie location specified and %fm locatipn's previous value is used to point to the next 
location unless the value is an absolute zero. 

Tag characters 5 and 6 are used for external definitions. Tag character 5 is 
applicable when the location is prograiVv-t'cteiatfible^ Tey ch^acteF is u^ When 
the location is absolute* Field 1 provides the link to the external definition, and field 
2 contains the six-character symbol of the external definition. 

Tag character 7 precedes the checksum, which is an error-detection word. The 
checksum is the two's complement of the sum of the 8-bit ASCII values of the 
characters in the record from the first tag of the record through the checksum tag. 

Tag character 8 may be inserted in place of tag character 7 so that the Loader 
ignores the checksum. The field contains the previous checksum. 

Tag characters 9 and A are with load axidressea for following data. Tag 
character 9 is used when the load address 1» absolute, while tag character A MiSM^m 

that the load address is program-relocatable. The field contains the address at which 
the following data word is to be loaded, A load address is required for a data word 
that is to be placed in memory at some address other than the next address. 

Tag characters B and C are used with da^ words. Tag charactw B \9 used when the 
data is absolute, such as an instruction word or a word that contains text characters 
or absolute constants. Tag character C is used for a word that contains a 
program-relocatable address- The field contains the data word. The Loader places 
the data word in the memory location specified in ttie preceding load address field or 
in the memory location that follows the preceding data word. 

Tag character F indicates the end of the record. 
The following table summ^izes eha^et^te? ^tgs. 
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Character Tag Summary 



Tao 


Use 


Field 1 


0 


Program Identification 


Program Length 


1 


Entry Point Definition 


Absolute Address 


2 


Entry Point Definition 


Relocatable Address 


3 


External References 


Relocatable Address of Chain 


4 


External References 


Absolute Address of Chain 


5 


Extwnal Definitions 


Relocatable Address 


6 


External Definitions 


Absolute Address 


7 


Checksum Indicator 


Checksum 


8 


Checksum Ignore 


Any Value 


9 


Load Address 


Absolute Value 


A 


Load Address 


Relocatable Address 


B 


Data 


Absolute Value 


C 


Data 


Relocatable Address 


F 


End of Record 





Program ID 



Symbol 
Symbel 

Symbol 
Symbol 



15.2.2 CompresflNKl Object Code Format 

This format is a condensed version of normal object code. Compressed object code 
results in a considerable savings of diskette space compared to the normal object 
format. You cannot change or edit compressed object code. Instead, change the 
source code and reassemble it. 
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15.5 CHANGING OBJECT CODE 

Correction of the object code that the Assembler produces may only require changing 
a character or a word. You can adit the object code using the Editor. Because M 
itmige^ cause a checksum error when c^iecksum is verified as the recOTd is 
loaded, you must change the 7 tag character to an 8. 

You can only change uncompressed object code. After you have finished editing, 

save tm ftim in ^ f ormt. 

For best results, when more extensive changes are required, change the source code 
and reassemble rather than writing additional object code records. 
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15.4 MACHINE LANIQUAGE; F^ORMAT 



Same of the data words preceded by tag character B represent machine instructions. 
Comparing the source listing with the object code fields identifies the data words 
that represent rriiaeMl^ instructions. The following table shows tht rmmri^ in wfilch 
the bits of the machine instrue£ldiia^e4flf|e.l^ -|^ Operands in source statements 
for each format of machine instruction. 



Machine Instruction Formats 





10 


11 


12 


13 


U 15 


1^ 


[7 IB 


19 I10iHil2U>ll4U§ 


I 


11 


11 


ix 


|WB 


Td 


1 


D 


1 Ts 1 


s 


I 


11 


10 


IX 


IWB 


Td 


1 


D 


1 Ts 1 


s 


I 


10 


11 


IX 


|WB 


Td 


1 


D 


1 Ts 1 


s 


II 


10 


10 


10 


11 


X IX 


IX 


IX 1 


DISP 




III, IX 


la 


10 


11 


IX 


X IX 


1 


D 


1 Ts 1 


s 


IV 


10 


10 


11 


11 


0 IX 


1 


NLM 


1 Ts 1 


s 


V 


10 


10 


10 


10 


X 10 


IX 


IX 1 


COUNT 1 


REG 


VI 


10 


10 


10 


10 


0 11 


ix 


IX IX 


IX 1 Ts 1 


S 


VII 


10 


10 


10 


10 


0 10 


11 


11 IX 


IX IX 10 10 


jo 10 10 


VIII 


10 


10 


10 


10 


10 10 


11 


10 IX 


IX IX 10 1 


REG 


X 


10 


10 


10 


10 


10 10 


u 


11 10 


10 11 1 


REG 



Key ; 

X A bit of the operation code that is either 0 or 1, according to the specific 

instruction in the format. 

WB A bit of the operation code that is 0 in instructions that operate on words 
and 1 in instructions that operate on bytes. 

Td A pair of bits that specify the addressing mode of the destination operand. 

QQ specifies Workspace Register addressing. 01 specifies Workspace 
Registur iMrect addt^sslni^ 10 specifies symbcdie memory addrming when 
D ei|ualB 0 and indexed memory addressing when D is not equal to G. 11 
specifies Workspace Register indirect auto-inerement addressing. 

D The Workspace Register for the destination operand. 

Ts A pair of bits that specify the addressing mode of the source operand as 

shown for Td» 

3 Tht Workspacid ^sg^lcr fof the source operand. 

NUM The number of bits to be transferred. 

DISP A two's complement number that represents a displacement. 

REG A Workspace Register address. 
COUNT A shift count. 
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X5.5 OUTPUT EXAMPLE 

The Bxampie of a erash sound, given tn Section ZO.4.3, produces the listing and object 
cocte shown below. 



15.3.1 Listing 

The following is the listing produced when the crash program is assembled. 

99/4 ASSENfiLER 

VERSICN 1.1 PA:£ 0001 

* 

* Exatple Progrcm to make a crash sound. 

0003 * 

0004 REF \^eA/ 
0003 CEF CRASH 

wm * 

0007 1000 BLFPERBGU >1000 VCP RDM buffer used by stiund generator. 

we • 

0009 0000 01 HDl BYTE >01 

0010 EVEN 

0011 * 

0013 0002 0200 LI RO,BLFF)ER Load yOP BftA buffer address. 

0004 1000 

0014 0006 0201 LI RljCCATA Pointer to the sound data. 
0008 0038' 

0013 OOOA 0202 LI R2,32 32 bytes to nove to the NCP Bm buff&r. 

0016 OOOE 0420 BJ/P ©iTwBW M3ve to \CP R/JM buffer, 
0010 0000 

0017 • 



UTP 

0019 0012 0300 LIMI 0 Disable VCP interrupt. 

0014 0000 

0020 0016 020A LI R10,ELFFtR Load sound table address. 
0018 1000 

0021 001AC8QA NCV R10,|^83CX: Load pointer to the table. 
OOlC 83CC 

Ot^Z OOIE FBZO SQCB gHDl,ii>83FD Set VCP ROM flag. 
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0020 


0000* 








0022 


83FD 






0023 


0024 


D620 




M3Wa @HEI1,@>83CE Start sound processing. 




0026 


0000' 








0028 83CE: 






0024 


002A 0300 




LIMI 2 Enable ^OP interrupt. 




002C 0002 






0025 






* 




0026 






L(XP2 




0027 


002E osao 




NCVB @>83CE,@>83CE Check if tirre i« up* 












0032 


83CE 






0028. 


0034 


13EE 




OEQ LOCP Repeat the sound. 


0029 


0036 


lOFB 




JvP L0CP2 Wait until finished. 


0030 






» 




0031 


0038 


03 


CCATA 


EP/IE >03,>9F,>E4,>F2,5 




0039 


9F 








QQ3A 


E4 








003B 


F2 








003C 


05 






0032 


003D 


02 




BYTE >02,>E4,>F0,12 




003E 


E4 








003F 


FO 








0040 


OC 






0033 


0041 


02 




BYTE >02,>E4,>F2,10 




0042 


E4 








0043 


F2 








0044 


OA 






0034 


0045 


02 




BYTE >02,>E4,>F4,8 




0046 


E4 







99/4 ASSSvBUER 

VERSICN 1.1 PfiCE. 0002 

0047 F4 

0048 08 

0035 0049 BYTE >02,>E4,>F6,6 

004A E4 

004B F6 

Q04C 06 

0036 004D 02 mm >02,>E4,>F8,4 
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004E 


E4 




004F 


F8 




0050 


04 


0037 


0051 


S2 




0052 


E4 




0053 


FA 




0054 


02 


0038 


0055 


01 




0056 


vr 




0057 


00 



0039 



mm. >02,>E4,>FA,2 



BYTE >01,>FF,0 



EM) 



99/4 ASSHvBLER 
VERSIGN 1.1 

a-FFER lOOO 
UOCP 0012 
RIO ODOA 
R14 OOOE 
R4 0004 
R8 0008 
0000 ERRCRS 



• LjaCP2 
Rll 
R15 
R5 
R9 



QQ3S 


□ CRASH 


0002 


» HOI 


002E 


RO 


DOOD 


Rl 


OOOB 


R12 


OOQC 


Ri3 


OOOF 


R2 


0002 


R3 


0005 


R6 


0006 


R7 


0009 




0010 





FWGE 0003 
0000 

0001 
OOOD 
0003 
0007 



15.5.2 Object Code 

The following is the object code produced when the crash program is assembled. 

00058 OOOOB0100B0200B1000B0201C0038B0202B0020B0420B00007F39^ 0001 

A0012B0300BOOOOB020AB1000BC80/iB83aLBF820COOOOB83Fm:620C00007F2C6F 0002 

AO(^^3t:EB0300B0002BD820B83CEB83CEB13EEBlQFBB039FBE4F2B05027F23aF 0003 

A0a3EBE4F0B0C02BE4F2BQA02BE4F4BOB02BE4F6BO602BE4F8BQ4O2BEAFA7F21BF 0004 

A0054B0201BFF007FC8CF 0005 

30010Vfv8W 50002CRASH WPOXF 0006 

! 99/4 AS 0007 
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Bmstmsl ^MMies me provided to give you 8i^n|)le aei^sfia to mafty of tifm of 

Tl Hbme Csmfai^. WWh ttmm MMiast fms em ohanfe tfm dl^a^y, etMss ttie 
Device Service Routine for peripheral devices such as disk drives and printers, scan 
the keyboard, link your program to GPL routines that perform a variety of useful 
tasks, and link to the Editor/ Assembler Loader, This section discusses these utilities 
and many of the predefined ftynribate. Other pped«stinfid symbols, usffld for sound and 
speech, are -discussed in Sections 20 and 22* 

Normally, it is difficult to v/rite to and read from VDP RAM and VDP Registers 
because they, like GROM and speech devices, are memory mapped. To read from 
most memory-mapped devices, you must first write a value to a specific address, vvait 
whiie the data is obtained, mvi then ri»ad the data from another address. To write to 
most memory-mapped devices, a similar process occurs: put the data in an address, 
write a value to an address to signify that the data is to be written, and then wait 
while the data is written. This requires detailed knowledge of the addresses to use 
and how to use them. 

The utilities and predefirM ^rnbOlB &b loaded at the same time as th& Load^. YtHi 
can make them available by mentioning them in a REF statement at the beginning of 
your assembly language program, accessing them with a BLWP instruction, and using 
Registers to pass arguments. They are also loaded into the Memory Expansion unit 
for tise "Whrn the tl basic subroutines INIT or LOAD are called. 

The utilities are predefined in the REF/DEF table at memory locations >3F38 through 
>3FFT". They use UTILWS, starting at address >2094, as utility Workspace Registers, 
All parameters are passed through your program's Workspace Registers, The USRWSP 
«^ea at >20BM trvc^ be^osed for your Workspace Registers. 

The following list gives each of the utilities predefined in the R^/DET table and 
describes briefly what each does. Sections 16.1 and 16.2 provide a more detailed 
discussion. 
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Name Use 

VSBW Writes a single byte to VDP RAM. 

VMBW Writes multiple bytes to VDP RAM. 

VSBR Reads a single byte from VDP RAM. 

VMBR Reads multiple bytes from VDP RAM, 

VWTR Writes a single byte to a VDP Register. 

KSCAN Scans the keyboard. 

GPLLNK Links your program to Graphics Programming Language routines. 

XMLLNK Linkd ymff pr@gNtt& ta ttit ^^cftbly JMpiage.mitines in the omisolm 

ROM or to RAM. 

DSRLNK Links your program to Device Service Routines. 

LOADER Links your program to the Loader to load TMS9900 tagged object 

code. 



Several geMral addrer&ses are predefined with symbols. You may use them 
instead of the addresses they represent so that you do not have to memorize the 
addresses. Their use is described in Section 16.3. 



Name 
SCAN 
UTLTAB 
PAD 



GPLWS 



Address Data Contained 
>000E 

>2022 
>8300 



>83E0 



Entry address of the keyboard scan utility. 

Utility table entry address. 

The scratch pad used by TI BASIC, GPL, TI BASIC, and 
other programs. You may use some areas. See Section 
24.3.1 for a detailed description of this area. 
GPL Workspace. 



Some addresses that are useful for accessing memory-mapped devices are predefined 
with symbols. You may use these symbols in your own memory access routines 
instead of the utilities described above. The use of these symbols is described in 
Sections 16.4 and 16.5. 



Name 


Address 


Data Contained 


VDPWA 


>8C02 


VDP RAM write address. 


VDPRD 


>8800 


VDP RAM read data. 


VDPWD 


>8C00 


VDP RAM write data. 


VDPSTA 


ymoz 


VDP RAM status. 


GRMWA 


>9C02 


GROM/GRAM write address. 


GRMRA 


>9802 


GROM/GRAM read address. 


GRMRD 


>9Bao 


GROM/GRAM read data. 


GmMWD 


>9cm 


GROM/GRAM vwite data. 
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16.1 VDP RAM ACCESS UTILITIK 

Several utilities provide access to Video Display Processor RAM. Ail parameters are 
passed through your program's Workspace Regist^^ TNe uHIItiSd i^e diSK^ib^ 
below. 

Note: Before you change VDP Register 1, put a copy of it at address >83D4, The 
bit that turns the screen on and off, which is used when no key is pressed for a 
certain time, is in VDP Register 1 and is stored at that address. Therefore, if you 
do not put the GOpy there^ the dereen returns to a prior state when you pifm9» a key. 



BLWP @VSBWt 



VDP RAM Single Byte Write—Writes the value in the 
most-significant byte of Register 1 to the VDP RAM address 
indicated in Register 0. 

Register 0: Attd^ in VDP ^M. 

Register 1; Most-significant byte contains the value to be 
written. 

For example, If l^ngiatfir 0 Is >ldOQ and Regtster 1 i« >2345, the 
inamietion oqU «T»eS8 >i0OO tfiA^P RAM equal to >23. 



BLWP @)VMBW: 



VDP RAM Multiple Byte Write— Writes the number of bytes 
indicated in Register 2 from the RAM buffer pointed to by 
Register 1 to the VDP RAM buff^ pointed to by Register 0. The 
RAM buffer is normally ineliidad' ill y«ur |iro^Nmi space with the 
BSS Mtruotion. 



Register 0; Starting address of the buffer in VDP RAM. 

Register 1: Starting addredft «rf the buffer In ^AM. 

Register 2: The number of bytes to be written. 

For example, if RegistM* Q h >IQOO, Register 1 Ss >^2MS, and. 
Register 2 is >0014, the In^uetlon «ets addrama >IdQO tt^^ 
>1013 in VDP RAM equal to the 20 bytes starting at address >2345 
in the Memory Elxpansion unit. 

BLWP (aVSBR: VDP RAM Single Byte Read—Reads a byte from the VDP RAM 
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address indicated in Register 0 and places it in the most-significant 
byte of Register 1. 

Regi^cr 0» A'ddress in VOP RAM. 

Register 1: Value is placed in the most-dgnlficant byte. 

For example, if Register 0 is >1000 and address >1000 contains >12, 
the inai^ctlon sets the most-significant byte of Register 1 to >12. 

BLWP @VMBR; VDP RAM Multiple Byte Read— Reads the number of bytes 
indicated in Register 2 from the RAM buffer pointed to by 
Register 0 and places them in the CPU RAM buffer pointed to by 
Register 1. 

Register 0: Starting address of the buffer in VpP RAM. 

Register 1: Starting address of the buffer in RAM. 

Register 2: The number of bytes to be read. 

For example, if Register 0 is >1000, Register 1 is >2345, and 
Register 2 is >0014, the instruction reads the 20 bytes starting at 
address >1000 in VDP RAM and sets addresses >2345 through >2358 
In CPU RAM eqiral to those byte& 

BLWP §VWTR: VDP RAM Write Register— Writes the value in the least-significant 
byte of Register 0 to the VDP Register indicated in the 
most-significant byte of Register 0. 

Register 0: Least-significant byte contains the value to be 

written. Most-significant byte indicates the VDP 
Register to be written to. 

For example, if Register 0 is >010E, the instruction loads VDP 
Register I with the value >0E. See SeeUon 16.A fmr more 
information on the VEDP Registers. 
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16.Z EXTENDED UTILITIES 

Five utiliUeSt called extended utllUis% ^iHSmi ymi to access the routines built into the 
Hemm CMputer. KSCAI^ BQism you £0 tNe mMm scans the keyboard. 
GPLLNK allows you to link to Graphics ftegracfin)^ Language routines. XMLLNK 
allows you to use routines in ROMs. DSRLNK allows you to link to Device Service 
Routines. LOADER allows you to load assembly language programs. 

16.2.1 KSCAN 

The KSCAN utility allows you to access the key scan routine in the computer. To 
use this utility^ you must include REF KSCAN in your program, select the keyboard 
device to be checked, and call the utility witfi the instruction 

BLWP ©KSCAN 

Then check the STATUS byte to see if a key has been pressed for the first time and 
eheek an address to see what the key was. You can also check to mne if ^ Wired 
Remote Controllers have been moved. 

Select the keyboard device to be checked by placing a byte at address >8374. A 
value of >00 checks the entire keyboard. A value of >01 checks the left side of the 
keybciiai^ md f^ees the values itom Wteed f^emote Coiitroller unit number om In 
mmwBtBB >B576 CV-pntttUon) and >8577 OC-iWttlltan^ A value of >02 checks the right 
ride of the keyboard and places the values from Wired Remote Controller unit number 
two in addresses >8376 and >8377. The values that may be returned in the addresses 
for the Wired Remote Controller are >04 (up or right), >00 (center), and >FC (down or 
left). For more Information on key units, see the explanation of the CALL KEY 
subpro^m in the User% Reference Guide. 

The status bit which indicates if a key has been pressed can be tested with a compare 
ones corresponding (COC) instruction. The STATUS byte is at address >837C and is 
as shown t^^w. 



bit I 0 I 1 I 2 I 3 I 4 i 5 I 6 I 7 i 
I H 1 GT ICOnD ICARRYl OVF I 0 I 0 | Q | 
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When KSCAN is called, bit 2 of the STATUS byte is set if a l<ey was pressed that was 
different from the key pressed on the last call to KSCAN. The ASCII value of the 
key pressed is placed at address >8375. If no key was pressed, this address contains 

For example, if your program places >00 at address >8374, BLWP (3KSCAN is called, 
and the B key is pressed for the first time, then bit 2 of the byte at address >83C7 is 
set, the value >42 is in address >8375. 



16.2.2 GPLLNK 

GPLLNK allows you to use routines written in Graphics Programming Language. 
These routines allow you to perform such tasks as loading character »Bts, giving 
tones, allocating space for strings, and so on. Some of the routines are described 
below. 

To use GPLLNK, you must include REF GPLLNK in your assembly language program, 
set the STATUS byte (at address >B37C) to >00, brantih to QPLLNK with mm 
provide the address of the routine in the console as data. For example, the following 
instructions branch to the routine which loads the standard character set. 

REF GPLLNK 



CLR Rl 

MOVB R1,@>837C 

BLWP ©GPLLNK 

DATA >0016 . 



The GPL routines described below return to your program when they finish exeoutlng. 
This ut;Ulty lets you mmem sny address in GROM. However, other routines than the 
ones givW) tnt^ bram^ to other code or have other side effects. To be sure that a 
routine returns to your program, check to see that it ends with a GPL return 
instruction C>00). You must also check that the routine does not use memory areas 
that your program is also using. 
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In the routines shown below, FAC (the Floating Point Accumulator) starts at address 
>834A and ARG (which contains arguments) starts at address >835C. The STATUS 
byte is at address >837C. VSPTR is at address >836E, 



General Purpoae GPL RoiiUiM 

The following are some useful general purpose GPL routines which you may access 
With GPLLNK. 

DATA >0016 Load Standard Character Set— Loads the standard character set into 
VDP RAM. 

Input: FAC is a pointer to the beginning address in VDP RAM where 
charactei^ me to be ioadeid^ 

DATA >0018 Load Small Capitals Character Set— Loads the small capitals character 
set into VDP RAM. 

Inputs FAC ^ a pointer to the beginning address in VDP RAM where 
characters are to be loaded. 

DATA >0020 Execute Power-Up Routine— Initializes the system. 

Output: The sound and VDP circuits are cleared and the default values 
for the VDP Register*, eharaofen- set^ eoior table, and «tatt» 
block are loaded. The available VDP RAM size Is stored at 
>8370. 

DATA >0034 Accept Tone— Issues the tone associated with correct input. 

DATA >0036 Bad Response Tone— Issues the tone associated with incorrect input. 

DATA >0038 Get String Space Routine—Allocates a memory space in VDP RAM 
with a specified number of bytes. This routine should not be used 
outside the Tr BASIC environment. If there is not enough space* the 
routine does a "garbage collection" t0 eUminal^ tempOT^ itrlnp and 
then tries again. If there is still not ^ough Space, the routine issues 
the MEMORY FULL error message. 
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Input: Addresses >830C and >8JQ0 should contain the numtifer of 
bytes to be allocated. 



Output ^Mi^^esfi >&31C points to ©i# ^lUic^ti^ string space and 

ad^^ >831A points to the fim free adtfi*^ Ifi VDP RAM* 
The four bytes at addresses >8356 through >8359 are used by 
this routine. The FAC area may be destroyed if a garbage 
collection is done. 



Notes Although this routine is designed to allocate a strtf^ 
VDP RAM, it is also usei^I for assigning space for the ^eripNMl 

Access Block (PAB) and data buffer required by a DSR. See Section 
18.2 for a description of Peripheral Access Blocks. 

DATA >t^^B Bit Reversal Routlne«>Provides a mirror image of a byte. This routine 
is used to form a mirror image of a character definition. 

Input: FAC is the address of the data in VDP RAM. FAC+2 (>834C) 
is the number of bytes to be reversed. 

Output: In each byte, bits 0 and 1, 1 and 6, 2 and 3, and 3 and 4 are 
exchanged. CPU RAM addresses >83Q0 through >8340 are 
destroyed. 

DATA >003D Cassette DSR Routine —Ace esses the cassette DSR routine. 



Input: The Peripheral Access Block and data buffer must be set up 
in VDP RAM prior to the call. The screen offset for TI 
BASIC is >60 and >00 outside the TI BASIC environment. 
The screen start address must be >00 for the prompts issued 
by the cassette DSR. FAC is the device name (for example, 
"CSl"). Address >8356 points to the first character after the 
name in the PAB. Addresses >8354 and >a355 are the length 
of the name (for example, >0003 for "CSl"). The word at 
address >B3D0 should be set to >000D. Address >836D must 
be set to >08 to indicate a DSR call. The STATUS byte must 
be >0Q. 



Output: The cassette DSR prompts for the operation of the cassette. 
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DATA >004A Load Lower-Case Character Set (TI«99/M only)— Loads the lower-case 
character set into VDP RAM. 

Inputs I^AC W a fiotntiBr to the beginning ad^^ Iti VDi» RAM wtmre 
characters are to be loaded. 

16.2.2.Z Mathematical Routines 

When errors occur during the exetsuCidn of these floating point routine^ they are 
Indicated at address >8354 with the error codes listed. 



Code 


Error Description 


01 


Overflow 


02 


Synias! 


03 


Integfttr overfttiw on conversion 




Square root of a negative number 


05 


Negative number to non-integer power 


06 


Logarithm of a non-positive number 


07 


Invalid argument in a trigonome^le function 



The abbreviations for these routines given In parentheses are the TI BASIC funcUons 
which call the routines. 

DATA >0014 Convert Number to i^trlng (ST R)— Converts a floating point number to 
an ASCII string. 

Inputi FAC contains the eight bytes defining the number. FAC+11 
(>B335), if set to 0, indicates that the output string is to be 
in TI BASIC format. Otherwise, the output is in FIX mode. 
If fix mode is Mleated, then 0»i556) and FAC-f 13 

08>!?7} must contain data. FAC+12 is the number of 
dgnlficant digits. It contains 0 to express overflow from the 
calculation range. FAC+13 indicates the number of digits to 
the right of the decimal point. A negative value disables the 
nx mode. 
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Output: FAC is modifieid, FAC+11 (>8355) contains the least 

Bignificant byte of the address where the result string is 
located. >8300 must be added to FAC+11 to find the address 
of the result string. FAC+12 (>8356) contains the length of 
the result string in bytes. 

DATA >0022 Greatest Integer Function (INT)~Computes the greatest integer 
contained in the value. 



Input: FAC contains the floating 

Output: FAC contains the result. 

the truncated value. For 
truncated value plus one. 



point value. 

For positive numbers, the Integet Is 

negative numbers, the integer is the 
The STATUS byte is affected. 



DATA >0024 Involution Routine— Raises a number to a specified power. 

Input: FAC is the exponent value. ARG is the base value. 



Output: FAC is the result in floating point format. The result is 

computed as E?^P(B3(ponent-V8lue*LOG[ABS(ba8e-value)^. The 
STATUS feytt ts afteteiJ* Us&ations >8375 and >t576 are 
destroyed and the word content of VSPTR is decremented by 
eight. 



DATA >O02£ Sqpitre Rtmt Routine (5QR)— Computes the square root of a number. 



Input: FAC is the input value. 



Output; FAC is the square root of the input value. The STATUS byte 
is affected. Ad^E^esses >8375 and >8376 are destroyed. 

DATA >O0Z8 Exponent Routine (EXP)— Computes the inverse natural logarithm of a 
number. 



Input: FAC is the input value. 



Output: FAC is the result value. The STATUS byte is affected. 
Addresses >8373 and >8376 are destroyed. 
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DATA >002A Natural Logarithm Routine (LOG)— Computes the natural logarithm of a 
number. 

Ir^tt FAC is the input value. 

Output: FAC is the result value. The STATUS byte is affected. 
Addresses >8375 and >8376 are destroyed. 

DATA >002C Cdsine Routine (COS)— Computes the cosine &f a AUnnbttr expressed in 
radians. 

Input: FAC is the input value. 

Output: FAC is the reault value. The STATUS byte is affected. 
Addresses >8375 and >8376 are destroyed. 

DATA >002E Sine Routine (SIN)— Computes the sine of a number expressed in 
radians. 

Input: FAC is the input value. 

Outputs FAC is the result value. The STATUS byte is affected. 
Addresses >8373 and >8376 are destroyed. 

DATA >003Q Tangent Routine (TAN)— Computes the tangent of a nuTKrtMw expressed 
in radians. 

Input: FAC is the input value. 

Outputs FAC is the result value^ tm trAtUS Isyt^ is affected. 
Addresses >8375 and >t376 a^e dstdtrbyed. 

DATA >0032 Arctangent Routine (ATN)— Computes the arctangent of a number 
expressed in radians. 

Ir^Mtt FAC is the input value. 

Output: FAC is the result value. The STATUS byte is affected. 
Addresses >8375 and >8376 are destroyed. 
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Note: A GPL routine is executed in the main program of the Editor/Assemfaler, 
Prior to transfer to the Editor/ AssemblGr, the GPLLNK routine sets a flag. 
However, the Editor/ Assembler main program checks the GPL status bit for error 
handling before it checks for the flag set by the Gff^NK routine. Thus, you rmBt 
reset that status bit at address >837C before calling GPLLNK. Otherwise, a 
meaningless error menage Is returned. 

16.2.3 XMLLNK 

The KN^XNK u^Uly aUow» you to Unk an s»»etfnt% language program to a routine in 
ROM or to branch to a routine In the Memory Expansion unit. The ROM routines 
perform such tasks as floating point arithmetic, stack arithmetic, string to number 
conversions, and so on. 

In linking to console ROM routines, you refer to table entries with DATA 

instruction&t These table entries contain the addresses of the routines which you 
wish to execute. The following describes the routines contained in the tables and the 
addresses of the tables. Each entry in the table takes up two bytes, so the addresses 
accessed are incremented by two for each entry. 



To link to a routine in ROM, the DATA instruction is followed by a word that 
specifies the table and entry you wish to use. The first byte of the word indicates 
the table and entry you are referring to, with the second byte equal to >00. 

The first nybble of the byte is from >0 through >7, indicating the table which you 
wish to use. The second nybble of the byte is from >0 through >F. When doubled, it 
ImfMti^ offaet trom the beginning of the table, from >QQ through >1E. For 



Table 
Number 




Address 

Specified at >OCFA 
Specified at >0P^ 



>0 
>1 
>t 
>3 
>4 
>5 
>6 
>7 



>2000 

>3FC0 
>3FE0 
>4010 
>4030 
>6010 
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^eaniple* DATA >13DD indlee^ the first table, two bytes from the beginning (the 
address of the beginning of the table is stored at address >OCFA); DATA >3400 
indicates the third table, eight bytes from the beginning, or address >3FC8; and DATA 
>5C00 indicates the fifth table, >18 bytes from the beginning, or address >40Z8. 

When yw t^andh to XMtLNK, thd ad^as of tNi irdteie to be ejceeutad is obtained 
frmn the table, and then the routine is executed starting at the address obtained. 
Fot example, the following sequence branches to the convert integer to floating point 
routine at address >ZQQ6 in the Memory Expansion unit. 

RET XMULNK 



• 

DATA >t3m 

You may also use the XMLLNK utility to branch to an address and start executing 
there. In this case, the DATA instruction is the address to which you wish to 
branch. The first bit of the word must be on, so the address may be from >8000 
through >FFFF, 

This use of the XMLLNK has the same effect as using the BL instruction (see Section 
7.2), except that the GPL Workspace Registers are used during the instructions 
executed after the branch. When the program returns, then your Workspace 
Rfif^iftE^ ittd agdn used 

For example, the following sequence branches to address >CU3A in the Memory 
Expansion unit. 

XMU.NK 



©XMLLNK 
>C13A 



REF 



BLWP 

mtA 
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16.2.3.1 ROM Routines 

The following describe some of the routines in ROM that you can access witti 
XMLLNK, giving the data ra^fcec^ the inpat, and the output. Since XMLLNK 
accesses routines in eorsdte, core must be tedcen to obtain the intended result. 

You must be sure that the GPL Workspace Registers are not changed, the memory 
space used in the routine is set up properly, and the utility returns to the calling 
program on completion, 

FAC (the Floating Point Acctinrtuldtdf) 9imU St address >^A, ARG (which contains 
arguments) starts at address >835C, and VSPTR is at address >836E. The STATUS 
byte is at address >837C. Ail overflow errors, except in Convert Floating Point to 
Integer (CFI), return >01 at address >8354. 

DATA >0600 Floating Point Addition (FADD)--Adds two values. 

Input: FAC is the first value and ARG is the second value. 

Output: FAC is the result of the addition. 

DATA >0700 Floating Point Subtraction (FSUB)— Subtracts two values. 

Input: FAC is the value to be subtracted. ARG is the value from 
which FAC is subtracted. 

Output: FAC is the result of the subtraction. 

DATA >0800 Floating Point Multiplication (FMUL)-- Multiplies two values. 

Input: FAC is the multiplier. ARG Is the multlpticand. 
Output: FAC is the result of the multiplication. 

DATA >090Q Floating Point Division (FDIV)— Divides two values. 

Input: FAC is the divlSdr. ARG is the dividend. 
Output: FAC is the result of the division. 
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DATA >OAO0 Floating Point Compare (FCOM)~Compares two floating point numbers. 



li^^ ARG is the first argument* F^C U &m amsm^ ce^yindnt. 

0|%|it: The STATUS byte is affected. The high bit is set if ARG is 
logically higher than FAC. The greater than bit is set if 
ARG is arithmetically greater than FAC. The equal bit is set 
if ARG and fAC are equal. 



DATA >0B00 Value Stack Addition (SADD)— Adds using a stack in VDP RAM. 



Input: VSPTR contains the address in VDP RAM where the left-hand 
term is located. FAC is the right-hand value. 

Outputs FAC is the result of the addition. 



DATA >0C00 Value Stack Subtraction (SSUB)--Subtracts using a stack in VDP RAM. 



Inputs VSPTR contains the address in VDP RAM y/here the left-hand 
term is located. FAC is the value to be subtracted. 

Output: FAC is the result of the subtraction. 



DATA >Otm Velue Stack MultipUcatton CSMUL}-Mia€lt^le8 u^ng a stack in VDP 



RAM. 

Input: VSPTR contains the address in VDP RAM where the 
multiplicand is located. FAC is the multiplier value. 

Output: FAC is the result of the multiplication. 



DATA >0E00 Value Stack Division (SDIV)— Divides using a stack in VDP RAM. 



Input: VSPTR contains the address in VDP RAM where the dividend 
Is located. FAC is the divisor value. 

Output: FAC is the result of the division. 
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DATA >OAQO Floating Point Compare (FCOM)— Compares two floating point numbers. 

IfftM ARG is the first fiargument. FAC Is the second drfw^^* 

'Dkdipifts T^ie STATUS byte is affected. The high bit is set if ARG is 
logically higher than FAC. The greater than bit is set if 
ARG is arithmetically greater than FAC, The equal bit is set 
II arvl -fMC am equal. 

DATA >0B00 Vsilue Stax^ Addition (5ADD)— Adds using a stack in VDP RAM. 

Input: VSPTR contains the address in VDP RAM where the left-hand 
term is located, FAC is the right-hand value. 

Output! FAC is the result of the addition. 

DATA >0C00 Value Stack Subtraction (SSUB)--Subtracts using a stack in VDP RAM. 

Input: VSPTR contains the address in VDP RAM where the ieft-hand 
term is located. FAC is the value to be subtracted. 

Output: FAC is the result of the subtraction. 

DATA >0D00 Value Stack MuiUpUcatlon (SMULM^uilJi^es using a Stack in VOP 
RAM. 

Input: VSPTR contains the address in VDP RAM where the 
multiplicand is located. FAC is the multiplier value. 

Output: FAC is the result of the multiplication. 

DATA >OE:oo Value Stack Division CSDIV)~Divides using a stack in VDP RAM. 

Inputs VSPTR contains the address in VDP RAM where the (fivldefid 
is located, FAC is the divisor value. 

Output; FAC is the result of the division. 
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DATA >0F00 Value Stack Compare (SCOMP)— Compares a value In the VDP RAM 
stack to the value in FAC 

Input: &st^^ the addresft iri VDP RAM MihOm ^ to 

ie c^dttvi^wrcKl Ido^isd^ FAC is the other value in thd 
comparison. 

Output: The STATUS byte is affected. The high bit is set if the 

value pointed to by VSPTR is logically higher than-FAO* The 
greater than bit is set if the value pitted to by VSPTR is 
arithmetically greater than FAC. The equal bit is Set if the 
value pointed to by VSPTR and FAC are e^|Mi^ 

DATA >1000 Convert String to Number (CSN)--CQnverts an ASCII string to a 
floating point numbw. 

Inputs FACi-12 is the address of the string in VDP f^AM. 

Output: FAC is the result of the conversion in floating point format. 

DATA >JJE10 Convart Floating Point ^ Ifitegor ^Tt^-Qonverts a floating point 
niia^t^ to an In^sr. 

Input: FAC is the floating point number to be converted. 

Outputs FAC Isf &m oneMMTord integjar vfiiuiu The nitttdimiiii vabie is 
>mT» If an overflow occun» FAC^i^|;0 0^8194) jft «^ ti9 
overflow error code, >03* 

DATA >2300 Convert Integer to Heating Point (C IF)— Converts an integer to a 
floating point numbw. 

Input: FAC is the one wend integer value to be converted. 

Output: FAC is the floating point result. 

Note: This routine is loaded in the Memory Expansion unit by the 
Editor/Assembler Loader. It is not loaded by the TI Extended BASIC 
Loader and may not be used in TI Extended BASIC. 
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X6^ZA DSRLNK 

DSRLNK links an assembly language program to any Device Service Routine (DSR) or 
subprogram in ROM* tfns data given is >8 for linkage to a Device Service HiMtiiie 
and >10 fat Mm^e to a subprogram* - Befdre this routine is called^ a Peripheral 
Access Block (PAB) must be set up in VDP RAM. A PAB is a block of memory that 
contains information about the file to be accessed. In addition, CPU RAM addresses 
>B336 through >6337 must contain a pointer to the device or subprogram name length 
In the See Section 18.2 for information on building a ^AB. 

After the routine is executed, information is passed back to your assembly language 
program in the UTLTAB area (see Section 16.3.2)* For instance^ suppose that the 
following sequence of instructions is executed. 

REF DSRLNK 



BLWP @DSRLNK 
DATA >8 

If no errors occur, the equal bit in the Status Register is reset on return from 
DSRLNK. If an I/O error occurs, the equal bit is set, and the error code is stored in 
the most-significant byte of Register 0 of the calling program's Workspace. 

Notm TNft touUne does not worie for easaa^ aeMm bn^aisa it only seardWM RDM 

DSRs and the cassette DSR is in GPL in the GROM. To access the cessette, BLWP 
(§GPLLNK with DATA >3D must be used. See Section 16.2.2.1 for more information 
on accessing cassettes. 

16^ LOADER 

LOADER loads TMS9900 tagged object code such as the Assembler produces. (See 
Section 19 for a description of the Loader and Section 13 for a description of tagged 
object code.) This utility is only used when you wish to load a file from your 
assembly linipiage program. Otherv^ise, selecting UQAD AND RUN from the 
Editor/Assembler or executing a CALL LOAD statement from TI BASIC is 
recommended. 
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Before this utility is called, a Peripheral Access Blocl< (PAB) set for OPEN mode 
must be set up in VDP RAM. A PAB is a block of memory that contains information 
about the file to be accessed. See Section 18.2 for information on building a PAB. 
In add^ion, CPU RAM «Kfcir©88<^ >8356 through >8357 must contain d pmtiter to the 
device or file name length in the PAB. 

For example, the following loads a fiie if the proper PAB has been set up, 
REF LOADER 



BLWP ©LOADER 

After the utility is executed, information is passed back to yot^ assembly language 
program in the UTLTAB area Csee Section X6.3.2). To access this data, you must 
include the instruction 

REF UTLTAB 

in your program. 



Address Name Information 

>20tZ% UTLTAB Entry address specified by a 1 or 2 tag. 

UTLTAB*>2 FSTHI First free address In high memory. 

UTLTAB+>4 LSTHI Last free address in high memory. 

LITLTAB+>6 FSTLOW First free address in low memory. 

UTLTAB+>8 LSTLOW Last free address in low memory. 



If no errors occur, the equal bit in the Status Register is reset on return from 
LOADER. If an I/O or load error occurs, the equal bit is set and the error code is 
stored in the most-significant byte of Register 0 of the calling program's Workspace, 

Notes The Loader does not close the file when errors occur, so In that case you 
must call the DSR to close the file. 
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16.3 PREDEFINED SYMBOLS 

Wmimi pt^eftmd ^mbois whl^ oart m&i fn plBS» ^ wMt&^s are included in 
the REF/DI^ wfhm ttm utiiitiea are loaded. You must list the symbols in a REF 
statement in ymit ass^bly language program to use them. 



l£.3a SCAN 

SCAN is the entry address of the keyboard scan routine in the console and is set to 
>OQOE. With SCAN, you have direct access to the keyboard scan routine KSCAN4. 
However, before using this address you must supply information to the GPL 
Workspace Kegisiait imd imd ttm Registers before branching to this routine. KSCAN 
does this for you. For example, the following instructions branch to this address. 

REF SCANjGPLWS 



LWPI GPLW5 

BL [§SCAN 
LWPI MYWS 



16.3-2 UTLTAB 

UTLTAB is the utility table. It contains information provided by DSRLNK (see 
Section 16.2.4) and LOADER (see Section 16.2.5). The following table lists the 

elemenU of UTLTAt^ ^itod mMms^ lAm mmm (i^an u»mi to mfm to 
them, and the information that they contain. 
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Reference 


Address 


Name 


Information 


UTLTAB 


>2022 


UTLTAB 


Entry address. 


UTLTAB+>2 


>2024 


FSTHI 


First free address in high memory. 


UTLTAB+>4 


>2026 


LSTHI 


Last free address in high memory. 


UTLTAB+>6 


>2028 


FSTLOW 


First free address in low memcs'y. 


urrtTAB*^ 


>202A 


LSTLOW 


Last free address in low memory. 


UTLTAB+>A 


>202C 


CHK5AV 


Checksum, 


UTLTAB+>C 


>202E 


Fl-GPTR 


Pointer to the flag in the PAB. 


UTLTAB+>E 


>2030 


SVGPRT 


GPL return address. 


UTLTAS*>ia 






l^yjttpddeess of the p^ipheiipal^ 


UTLTAB+>12 




SAVENT 


Cr¥^ adt^ess of the DSR or subprogram. 


UTLTAB+>14 


>2Q36 


SAVLEN 


Device or subprogram name length. 


UTLTAB+>16 


>2038 


SAVPAB 


Pointer to the device or subprogram name in 








the PAB. 


UTLTAB-i->ia 


>203A 


SAVVER 


V«r^ta mimNr of tho tMH* 



16.3.3 PAD 

PAD is the address of the beginning of the scratch pad in RAM* It is from addresses 
>B300 through >83FF. It is used by assembly lan^jud^e programs, console routines, 
and Graphics Programming Langtiage routines. See the Appendix for a complete 
description of this memory area. 
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16-4 VDP ACCESS 

Yt>u can access VDP RAM and VDP Registers directly instead of using the utUitiSa 
deacFitJed at the beginning of this tectlGn. The ftjllowing sections dBmonstrate how 
to use predefined addresses to access various memory areas. 

In accessing memory in VDP, allow enough tinne for the completion of the read from 
or write to memory. This can most easily be accomplished by following the 
instruction that uses Vne address with a NOP or SWPB Instouction. Alsof most of 
these addresses require that you read or write the least-slgnif leant byte first. 

16.4.1 VDPWA 

VDP'^^ lit the addresd of the )^0P WfM l^egister aH^ la mt. to mCQ2. 

ThU Register must be prepared when you wish to access VDP RAM. To set the 
address you plan to access in VDP RAM, move the two-byte address into this 
location. The least-significant byte is transferred first, followed by a delay (with 
HOP m WPS)^ and then the most-significant byte is transferred* It t^a'ta Is to b® 
written, the most-slgnifioant two bits of the address must be 01. 

For example, if the address to which you plan to read is in Register 1, the following 
code loads that address. 

RBF VDPWA Refers to the address. 



SWPB Rl Gets the least-significant byte first. 

MOVB Rl,iVDi^W Writes the l!»8sl^-^^il|ftent fe^te. 



The VDP RAM Register write address is auto-incrementing, so you can write 
mm&j^m bytes without modifying the IMte a^ktee^ 



SWPB 
MOVB 



Rl 

R1,@VWWA 
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You may also use this utility to change VDP Registers by setting the first bit, 
specifying the VDP Registw In ti« voGOnd nybble, and giving tlii» Vidltitt 1^ iwite in the 
seeand l^tB* For i»mlMll| ^ "^cMving code changes VDP Registor 2 to >01* 

REF VPPWA Refm to the address. 



LI 

SWPB 

MOVB 

SWPB 

MOVB 



Rl 

Rl,[aVDPWA 
Rl 

RX^VOPWA 



Gets the least-significant byte first« 

Writes the least-significant byte. 

Takes time and gets the most-significant byte. 

Writes the mort-tfgnlfieent bytse« 



16.4.2 VDPRD 



VDPRD is the address of the VDP RAM Read Data Register and id set to >8a00. 
The acktae of ^ VOP lf|AI<9 msA be set as described in Section 16^1. Data can 
then be road frorri ^i^3PRE}. 



For example, if Register 1 contains the address of VDP RAM that you plan to read, 
the following code puts the value from that address into Register 0. 



REF 



VDPWA,VDPRD 



Refers to the addresses. 



SWPB 

MOVB 

SWPB 

MOVB 

NOP 

MOVB 



Rl 

R1,@VDPWA 

Rl 

Rl,i!VDPWA 
@VDPRD^ 



Gets ehe te^^*#3iiifieant byte first. 
Vlfeitee the lesMft-^gnlfloatxi; byte^ 

Takes time and gets the most-signiflcant byte. 
Writes the most- significant byte. 
Takes time. 

Reads the data Uito Register 0. 



The VDP RAM Register read address is auto-incrementing^ so you can read successive 
bytes without modifying the read address. 
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16.A^J VDPWP 

VDPWD is the address of the VDP RAM Write Data Register and is set to >8C00. 
TNf md^km^ In H^H t& isHNIch you plan fee m&m data must first be specified with 
VDPII^ ^ mm'-0^0Mmit tmm M $et to Ol. Data is th0n moved to the VDP 
RAM wife data dddress when the instruction MOVB ©VDPWD is executed. 

For example, if Register 1 contains the address to which you plan to write and the 
W^G^-^nil^cit byte of Registo ? isi»^ato 0m Mm ym to Write, the following 
statenwits move the value from Register 3 to the specified address. 



REF 


V[^WA,VDPWD 


Refers to the addresses. 


• 
■ 

LI 


R2,>4000 


Sets Register 2 Wh the two most^significant 






bits equal to 01. 


SWPB 


Rl 


Gets the least-significant byte first. 


MOVS 


RljdVDPWA 


Writes the least-significant byte. 


SWPB 


Rl 


Takes time and gets the mi9^k>^cpil^eartt )s0e* 


SOC 


R2,R1 


Sets the two most-significant bits in Roister 1 






to 01. 


MOVB 


Rl,(aVDPWA 


Writes the most-^gnificant byte. 


NOP 




Tai<es time. 




R3,iVIDPWD 


Writes the data from the moet-^gni^aant ^te 



of Register 3. 



The VDP RAM write address is auto-incrementing, so you can write successive bytes 
without modifying the write address. 
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16.4^ VDPSTA 

VDPSTA is the address of the VDP RAM Read Status Register and is set to >8802. 
Ttte Settle Register U read; fey mo^rag it from that addrasa to the desiped deatination. 
Tha status is the most signi^cant byte of the address. 

For example, the following code moves the status byte to Register 1. 

REF VI3PSTA RaffiSa t& the address. 



MOVB (iVDPSTA,Rl Reads the Status Register. 

The VDP Status Register contains the following Information. 
Information 

VDP interrupt flag. Set if a VDP interrupt has occurred. This flag 
may be read even if interrupts have been disabled with the LIMi D 
instruction. The flag is cleared by reading the Status Register or by 
resetting VDP« 

Five sprites flag. Set if there are five or more sprites on a screen 
line. The flag is cleared by reading the Status Register or by 
resetting VDP. 

ColriGldertca fla§. Set If tarn m imm sfi^^it^s have overlapping pixels, 
including SfWltes that are trampf^ertt and w^tm tNtt -mB off the 
bottom of the screen. The flag is cleared by reading the Status 

Register or by resetting VDP. 

Fifth sprite number. Equal to the number of the fifth sprite on a line 
if the Coincidence flag is set. The value is cleared by reading the 
Status Register or by resetting VDP. 



Bit 

a 

1 
2 

3-7 
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16.5 GROM ACCESS 

f Hu mm hsm ^ MsFff^tai 1^ ^ ^W^U ^RAM in the Command Module by 
u^ng the four addresses described below^ 

In accessing memory in the GROM, allow enough time for the completion of the read 
from or write to memory. This can most easily be accomplished by following the 
ii1gt^yctf@n INil uses address with a ND^ SW^ tnstruction. Also, most of 
these addresses require that you read or write the most-significant byte first. 



16.5.1 GRMWA 



GRMWA is the address of the GROM Write Address Register and is set to >9C02. 
This Register must be prepared when a GROM address is to be accessed. To set the 

address to be accessed in the GROM, move the two-byte address into this location^ 
The most-significant byte is transferred first, followed by a delay (with NOP or 
SWPB), and then the second byte is transferred. 

For oxfift^alfiir if mMmaa to which you plan to read or write is in Register 3» the 
following code loads that address. 



REF 



GRMWA 



Refers to the address. 



MOVB K3,iiGRMWA 

SWPB R3 

MOVB R3,(iGRMWA 

SWPB R3 



Writes the most-significant byte. 
Takes time. 

Writes the least-significant byte. 
Return R«6gl9ter to Its original state. 



16.5.2 GRMRA 

QRMRA is the address of the GROM Read Address Register and is set to >98(^. 
tiW' IKdiMli in rpud frmflfV^ i^ two^^iyte address from the read address memory 
location to the destination. The most-significant byte is transferred first, followed 
by the least-significant byte. The address must be decremented by one. After being 
read, the GROM address value is indeterminate and must be restored or reset before 
further data accoai emn ts&sm^ 
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For example, the following statements move the address into VALUE and VALUE+1. 
RW GRMRA Refers to the address. 



MOVB ©GRMRAjgVALUE Reads first byte of the address. 
HOP Takes time. 

MOVB @C3mMRA,@VALUE+l K^^^ond byte of the address. 

DEC ©VALUE Corrects the address. 



16.3.3 GRMRD 

GRMRD is the address of the GROM Read Data Register and is set to >9800. The 
address of the GROM must be set as described in Section 16.5.1. Data can then be 
read from GRMRD. 

For example, if Registra" 3 contains the address of GROM that you plan to read, the 
following statements put the value from that address into Register 1. 

REF GRMWA,GRMRD Refers to the addresses. 



MOVB R3.1GRMWA 

SWPB R3 

MOVB R3,@GRMWA 

SWPB R3 

MOVB liGRMRD,Rl 



Writes the most^signif leant byte. 
Takes time. 

Writes the least-significant byte. 
Takes time. 

Reads the data into Register 1. 



16.5.4 GRMWD 

GRMWD Is the address of the (MOM Write Data R^Setev' and is set to >9C00. No 
data can be written to a GROM. However, if a GRAM is in place, you may write 
data. 

Foff exompl^ If Re^st^ 1 contains tbm addra^ te whi@h you plan tQ writs mnd 
Register 3 contains the dedte you wl^ td wflte, the following statements move the 
value from Register 3 to the specified address* 
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REF GRMWA,GRMWD Refers to the addresses. 

* 
■ 

MOVB Rl,(iGRMWA Writes the most-significant byte. 

SWPB Rl Takes time and gets the least-significant by 

MOVB R1,@GRMWA Writes the ieast-signif leant byte. 

NOP Takes time. 

MOV R3,iGRMWD Writes the data from Register 5* 
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The Editor/Assembler Command Module contains seven TI BASIC subprograms that 
can be used in addition to the subprograms described in the User's Reference Gui,de . 
They are described below and discussed in greater detail in Section 17-1. 



Eatamples of using sonriD of these sulsimgrams are given in Section 17*1.8. 

In addition, the Editor/Assembler diskette labeled Part A contains the file BSCSUP 
which contains several TI BASIC support utilities. These utilities allow you to access 
variables and values passed in the parameter list of the TI BASIC subprogram LINK. 
In additions ERR ^ows yeu ta retiufi an error to the cedling: TI BASIC program. 

These utilities use their own Workspace Registers, The WorkSpaoe Registers starting 
at USRW5 are loaded by the Name Search Routine in the utility before branching to 
your program and are available for your use unless your program runs because an 
entry poinit. was specified after the END directive (see Section 14.3.2). In this case, 
^^esD mmtlxpmsify that Werkspsce^yaia^elf or provide yottt awn W&tkapme0 BoQU^m 
All parameters are passed through the calling program's Workspace Registers. An 
example of using some of these utilities is given in Section 17.2.6. 

The Mowing list gives the avaUable ut^We .arid^cle«l9!l%ee Mafiy what each dQe& 
They are described in greater detMl in Section 17.2. 

Name Use 

NUMASG Makes a numeric assignment. 

STRASG MEd<es a string assignment. 

NUMREF Gets a num^ic parameter. 

STRREF Gets a string parameter. 



LOAD 

LINK 

PEEK 

PEEKV 
POKEV 



INIT 



CHARPAT 




ERR 



Reports errors. 



TI BASIC SUPPORT 



17*1 INTERFACE WITH TI BASIC 

Seven subprograms, which are included in the Editor/Assembler Command Module, are 

mXt MMM' mm ft^^iaAg with assembly language programs* fN 
LOAD, POKEV, PEEK* and KEHV suIs^ogramB can be ussed whether or not the 
Memory Expansion unit Is attached. They sh*© described In the foUowing sectiorm. 

i7.xa cAix mtr 

The temat of the INIT subprofiam is 
CALL INIT 

with no parameteps. The INIT 8i*s|sro§Pam teats tu be sure that ttte Memory 
Expansion unit is properly conneetedj, tads i^M^ -mmtkmi fxmm E^t^Mssembler 
module into the Memory Expansion unit starting at address >2000, and loads REF/DEF 
tables in the Memory Expansion unit at addresses >3F38 through >3FFF. 

The ZtsilT subp^o^am ^ould be caUed before assembly iangua^g^ j^^igmms are lo^ed 
by TI BASIC. If the INIT sd^xigmn Is ^led wfiSe m assambly lafigjifa^ program 
is in memory, it removes all information relating to that program, making the 
program inaccessible. However, the program itself may remain in mempry. 

17.1.2 CALL LOAD 

The format of the LOAD subprogram depends on the use to which it is put. It may 
be used to load an object file such as is produced by the Assembler or to "poke" data 
dirfectly into memory locations. 

17.1.2*1 Loading a Program with LOAD 

If you use the LOAD subprogram to load an assembly language object file, the format 

is 

CALL LOADC'obJe«^-^ename't»"0b}ec!t-filBname"^J) 
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The object filename is a string expression such as DSK1.0B3FILE. The file must 
contain assembly language object code, such as that produced by the Assembler. 
More than one file can be loaded at a time by separating the files you want to load 
with Gomfnas. 

For exampiei the statement 

CALL L0AD("DSK1.0BJ1","DSK1,0BJ2") 

loads the files OBJl and OBJ2 from the diskette in Disk Drive 1. 

Relocatable code is loaded starting at the first available address, which is set to 
>A00O by the INIT subprogram (described in Section 17.1.1). Room is reserved for 
the program acceding to the length speciAed in the character tog 0 field' in ttie 
Cb|e0t fil^^ ^ee SdCt^tin X%% for & description of character tags.) Absolute code Is 
loaded as specified in the assembly language program. 

CAUTION 

You mu»t take extrenrie cars that absolute code is mlly 
needed and works propwly* Loading data Into memory 
already being used by TI BASIC can cause the system to 
stop functioning so that you must turn the. computer off 
and back on in order to continue. 



If more than one program is loeuM, the additional programs ste Jto&ded In Mie 
memory following the previous |»i9^m. See Section 1? tor mme informatiori nci: Itie 
Loader. 



17.1.2.2 Poking Data with LOAD 

If you use the LOAD subprogram to put data directly into memory ("poking"), the 
format is 

CALL LOAD(addre88,value[,value,...C,**",addres8,value[,value,M.J]]) 
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Tt^ address is a numerical expression or variable from -32768 through ^llGl, 

-52768 teough -1 represent >8000 teough >FFFF m^mm^ In two's-qomplement form* 
To access an address above 32767, subtract 65536 from It. Th© Values, wWclJ OlMri;^ 
repeated, are decimal numbers which specify the byte values to be loaded startir^ at 
the address specified. For example, the statement 

CALL LOAD(-16384*2^21) 

places the values >FF and >15 in the bytes starting at acMress >CQQO. 

You can specify a new address and the values to be loaded starting at that address by 
H^mtWi^ the last value fmm Ihe new ac^^bera wi^ an etr^y string (""). For 
example, the statement 

CALL LOAD(-16384,255,21,"",8192,85) 

loads the «^me dsta £n to it€nm addresses as the piwious progrann and also itm^ 
value >53 at address >2000. 

You can use the LOAD subprogram to load a program directly into memory. 
However, you must enter the program name in the REF/DEF table so that the 
program can be run with the LINK subprogram (described in Section 17.1.3). 

To enter the program name in the REF/DEF tablej use the PEEK subprogram 
(described in Section 17.1.4) to find the values at addresses >2028 and >202A. These 
addresses contain the First Free Address in Low memory (FFAL) and Last Free 
Address in Low memory (LFAL), respectively. These values must differ by at least 
eight bytes to have space for your pr^Him tts^m and address. Ch»Rps LFAL to a 
vste ei^t less than its old vdlim, smd Wmi iwl £he pti^mm nsmm, up feo; ^tes, 
starting at the new LFAL address, followed by two bytes which give the starting 
address of the program. For example, suppose LFAL is >3F38, your program name is 
OBJl, and it starts at address >8300. Change LFAL to >3F30 and load OBJl, two 
spaces, >m W into addresses '>W^ ^mmik >JF^7 with ^ ^telWit 

CALL LOADa6176,79,66,7M9,52,32,131,00) 
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17.1-3 CALL LINK 

The f orrmt t£f tSm UMK stOsptt^mm h 

CALL LINK("program-name*l,papameter-U8t]) 

The program-name is from one through six characters that give the name of the 
adS6iin^y knguage program as it appears in the REF/DET tabl^ The a^mbly 
language program must be in memwy, and its name must be in the REF/DEF table. 
See the explanation of LOAD (Section 17.1.2) for more information. 

The optional parameter-list contains parameters you wish to pass from the TI BASIC 
program to your assembly language program. Using parameters is discussed in 
greater detail in Section 17.1,3.1. 

For example, the statement 

CALL LINK("START",1,3) 

links the TI BASIC program to the assembly language program START, with the 
values 1 and 3 passed to it. 

The following actions occur when the CALL LINK statement is executed, 

1. The utility program checks to see that the e^mbly language ppQgtmn name is 

from one through six characters long. If the name is of the right length, the 
Name Link Routine (which is part of the utility program) looks up the name of 
the program called in the REF/DEF table, starting at the lowest address. The 
Name Link Routine then pushes the program name on the vcdue stack* 

The Loader gives an error if you have duplicate names in DEF Instructions, and 
losing stops. 

2. When the program name has been located in the REF/DEF table, the Name Link 
Routine brancihee to the program with a (Mrect assembly language branch 

instruction. In order to return to TI BASIC, your assembly language program 
must retain the values in Workspace Registers 11, 13, 14, and 15 and restore 
those values before ending. 

3. Your assembly* litngue^e pFpg^am is executed. 
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4« When your program has finished executing, the utility branches to an error routine 
if an error has been detected. Otherwise, it clears the stack and returns to the 
TI B^^IC program norrrmUy. Adi^m >M0 a3iiMr» tim ij^iie Stack pointer in 
use by the TI BASIC int^preter. 

17.1.3.1 Passing Arguments with LINK 

You can pass up to 16 ar^iiMr^ ^^ur T! E^SIC program to your assembly 
language program. If a simple variable (any variable except an exptmag^P^ Is pas^i 
any changes made in the value of that variable in your assembly language piPogram 
also change the value on return to your TI BASIC program. Entire arrays are passed 
by following them with parentheses. If the array contains more than one dimension, 
the dimensians beyond the first are indicated by placl<hg commas between the 
jparentheses. 

For example, the following are all simple variables whose values can be changed. 
The last one is a two-dimensional array. 

A,B$,VAR(3),G«g 

If you wish to pass the value of a simple variable, but do not need the assembly 
language program to make changes in it, surround it with parentheses. However, 
arrays cannot be passed by vaXm* F'or B^e^mple, you can pass s^ but the l»8t @f 
variables listed iJwe wrlthciiit having their values affected on return to your TI 
BASIC program by listing them as follows. 

(A),(B$),CVAR(3)) 

In addition^ conitalfeB^ ^^ressions, such as A+3» do not have their values changed 
on return to your TI BASIC program. 

The arguments are passed to the assembly language program through an identifier list 
in CPU RAM, Address >8312 contains the number of arguments in the parameter 
list. The argument identitiert ^If^ specifies the type of argument, is located at 
addresses >200A MGPih >WX9* lilsntifi«F is one byte lit length* The values 

are 0 for a numeric expression, 1 for a string expression, 2 for a numeric v^iable, 3 
for 8 ^rlng variable, 4 for a numeric array, and 5 for a string array. 
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Note: You do not need to know exacly how argumcHits are passed if you use the 
utilities described in Section 17.2 

More infoi?ms^>Ft cm each iffgument is st^etJ in an eighMyte value stack in VDP 
RAM. 

0 If the argument is a numeric expression, the identifier is 0 and the stack 
contains the value of the numeric expression in radix 100 notation. In radix 
IQO notation, a number is from 1.000000000000 through 9M399999m9^ 
tnuittpUed by 100 raised to a power from -64 to 64. The first byte in the 
value stack indicates the exponent of the value of the numeric expression. If 
the exponent is positive, the byte value is 64 more than the exponent. If the 
exponent is negative, the byte value is obtained by subtracting the exponent 
from 64» For example, If the exponent is 2, the byte is ^ or >4^ If the 
exponent ts ^5, tYm byte is 61 or >3D. If the number is neg^adve^ the first 
word (the exponent byte and the first' ^te of the value) is given in 
two's-complement form. 

The remaining seven bytes indicate the value of the number. To find 
seven hftias, the number, in deciinal ftmn but with the decimal point mil^ffg^ 
is convwte<t tci h^eide^imal notation. For example, the foUliiWiirig shi^ how 
several values are expressed in radix 100 form. 

Stack Value 

>40 >07 >oo >&i >m KM >ao >oa 

>40 >46 >00 >00 >00 >00 >00 >00 
>43 >02 >22 >38 >00 >00 >0G >0G 
>43 >17 >2D >3C >ao >0D >00 >00 
>00 >00 »0C >XX >X< >X< >XX >X>< 
>BF >F9 >00 >00 >00 >0Q >0Q >00 
>BF >BA >00 >00 >00 >00 >00 >00 
>BC >FE >22 >38 >00 >00 >00 >00 

Notes The value 0 is expressed by >00 in each of the first two bytes and 
uttdefihtird' values' M ^ remaining six bytes. 



Decimal valu e Radix 100 Notation 
7 
70 

2,345,600 
23,456,000 
G 

-7 
-70 

-2,345,600 



7 X 100 
70 X 100° 
2.3456 X lOO'' 
23.456 X lOo' 
0 X 1Q0° 
-7 X 100° 
-70 X 100° 
-2.>456 X 100- 
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• If the argument is a string expression, the identifier is 1, Bytes □ luid 1 
contain >Q01C, byte t contains >65 ^ing tag used by the TI BMlC 
inl^qsif0%ii^ Uyi^ t \U itot bytes 4 and 5 contain a pointer to tfre value of 
the string in VPD RAM, and bytes 6 and 7 contain the length of tt1«| **rlrt$* 
Byte 6 is always zero because the maximum string length is 255 character. 

• If Ssft argument is a numeric variable or a numeric array element, the 
idenMs^ Hat ^inM^ a % Bytes 0 and 1 c^tal^ n points to the variable's 
symbol table entry in VDP RAM, byte 2 contains zero, byte 3 is not used, and 
bytes 4 and 5 contain a pointer to the eight-byte value of the variable in VDP 
RAM. 



• If the argument is a string vapiaibl6 m a string array element, fifee feaenOTBr 
list contains a 3. Bytes 0 and 1 conHfiUt a punter tm tim vrnti^t^m symM 
table entry in VDP RAM, byte 2 contains >65 (the string tag used by the TI 
BASIC interpreter), byte 3 is not used, bytes 4 and 5 contain a pointer to the 
string's value in VDP RAM, and bytes 6 and 7 contain the string length. 

V If the K^urrMt Ift a nworfe mmf Q»f tim form A() Mf), and so on, the 

identifier list contains a 4. Bytes 0 and 1 contain a pointer to the array's 
symbol table entry in VDP RAM, byte 2 contains zero, byte 3 is not used, and 
bytes 4 and 5 contain a pointer to the array's value space in VDP RAM. The 
value space hat two byle« for each dimension, indicating the maximum index 
fop that dimenMon. Following the tfifnert^on information are the values, stored 
in radix 100 notation. Note that in a numeric array the array elements are 
stored in cpnsecjjtive eight-byte sections of memory. 

• If the argument is a string array, it is similar to the entry for a numeric array 
except the identifier list contains a 5 and byte 2 of the stack entry contains 
>65. Thus bytes 0 and 1 contain a points ta ttie af^Sy** ^ItlM table entry in 

VDP RAM, byte 2 contains >65, byte 3 is not used, and bytes 4 and 5 contain a 
pointer to the array's value space in VDP RAM. The value space for a string 
array contains two bytes for each dimension, indicating the maximum index. 
FoUowin§ ^tm dimension Informmtlon mm t^t^ lor each array element 
which are used as a pointer to tfm mtMwm^M vato sMig In VPP Hoj^ 
that in a numeric array the array elements are stored in consecutive eight-byte 
sections of memory, while in a string array the elements are not usually in 
order. 
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17.1.4 CAUL PEEK 

The format of the PEEK subprogram Is 

CAUL l^*<(acto^V8^iabte-«8tE,'"',...]) 

The address is a numerical expression or Vdrtafsle from -32768 through 32767. 
Addresses from 0 through 32767 represent >0000 through >7FFF. Addresses from 
-32768 through -1 represent >8000 through >FFFF expressed in two's-complement form. 
To access an address above 32767) subtract 65536 from it. 

The PEEK subprogram reads bytes from CPU RAM and, starting at the address, 

assigns those values to the numeric variables in the variable-list. You can read ■ 
values starting at more than one address by separating the last value in the 
variable-list from the next address with an empty string (""). For example, the 
statement 

CALL PEEK(8192,A,B,C(B),"",-24576,X) 

places the value from address 8192 (>2000) in A, the value from address 8193 (>20Q1) 
In i, ttie value from acklresi 0X94 OZWZ) in C(3). and the value frmn Bd$tme ^24576 
OAOOD) in X. 



17.1.5 CALL PEEKV 

The forn^t of the PEEKV subprogam is 

CALL PEEKV(addre88,variable-U8t[,"",...]) 

The mkhm» U a ntime^l^l ex^esaibn or varia^ld from 0 tfrdu#t corresponding 
to VDP RAM addresses >0000 through >3PFF. 

The PEEKV subprogram reads bytes from VDP RAM and, starting at the tddress, 
assigns those values to the numeric variables in the variable-list. You can read 
values starting at more than one address by separating the last value in the 
variable-Ust from the next address with an empty strUig <"")• For mam^iB$ the 
statement 

CALL PEEKV(784,A,B,C(8),"",2,X) 



EDITOR/ ASSEMBLER 
Page 281 



TI BASIC SUPPORT 



places the value from address 784 (>0310) in A, WB ^itot ^.m address 785 C>0311) in 
B, the value from address 786 (>0312) in C(8), and £fm V^to from address 2 (>00D2) In 

tUh^tiDrtit^ m tHat ym must turn the qsmputer off and bttck on in mi^t to ^Ein^n» 



CALL POl^ 

Jfm temat the POKEV gubptogrEtm is 

CALL POKEV(address,vaiue-list[,"",»,]) 

The adtfress la a numierical exf^Bssidn or variable from D through 16383> corresponding 
to VDP RAM addresses >0000 through >3FFF. 

The POKEV subprogram writes bytes to VDP RAM from the value-list starting at the 
address. You can write values starting at more than one address by separating the 
last value in the value-iist from the next address with an ^mipJ^ f"*)» For 

example, the statenrient 

CALL POKEV(784,30,30,30,'"',2,V) 

pmm Itll m #J,E) in addW«BE^ m 7^5 0D311), and 786 (>03X2% and 

places the value of V in address 2 (>0002)* 

Note: Using an address higher than 16383 (>3FFF) can cause the system to stop 
functioning so that you must turn the computer off and back on in order to continue. 



17,1.7 C/U-L CHAHPAT 

The format of the CHARPAT subprogram is 

CALL CHAW AT(ohar£ecteBf-eocte,strlng-variableC,...l) 

The character-code is any character number from 32 to 159. The 16-character 
hexadecimal pattern identifier associated with the character code is returned in the 
string-variable. The pattern identifiers for characters 32 through 95 are normally 

% W Tl BASIC They can m 
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changed, and characters 96 through 159 defined, by the CHAR subprogram. See the 
User's Reference Guide for more information. 



17.1.8 TI BASIC Examples 

The following program initializes memory, loads the file SPRITE from the diskette in 
Disk Drive 1, and executes the program, starting at the entry point BEGIN. 

100 CALL INIT 

110 CALL LOADC'DSKl. SPRITE") 
120 CALL LINKC "BEGIN") 

The program below initializes memory, loads the TI BASIC support utilities (BSCSUP) 
and the file DSKl.TEfr,, and im00Mte$ the program, starting at the entry point TEST* 
The parameters passed to the assembly language program are the numeric array A 
and the string expression HELLO. After the assembly language program has finished 
running, the program prints the value of A(9). 

100 DIM A(30) 
110 CS?U-L INIT 

120 CALL LOADC'DSKl. BSCSUP", "DSKl, TEST") 
130 CALL LIfsKC "TEST", AO, "HELLO") 
140 PRINT A(9) 

The foliovi/ing commands read the one-word value at CPU RAM address >8370 and 
calculate and print the value. The value contains the highest memory location 
available in VDP RAM. 

CALL PEEK(-31888,A,B) 

PRINT VALUE 

The program below loads color table 16 at VDP RAM address >0310. As the program 
executes, the background color of the space characters on the screen changes rapidly. 

100 FOR 1=1 TO 16 

110 CALL Pa<EV(784,16+I) 

120 NEXT I 
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The TI BASIC support utilities are contained in the fiie BSCSUP on the 

^^^/ Assembler diskette labeled Part A, These utilities help you find the values, 

mi i^igh values to th© v^i^les, pagsed in the parameter-Ust of the LINK 

The five utilities are NUMA5G, STRASG, NUMF^EF, STRREF, and ERR. They are in 
relocatabie code and are a&gi^ -1?0ff % Isft Xsffig. can use them in your assembly 

language program by listing them in a REF statement. To load thern, put ttiG 
sfeatenriBnt 

CALL LOADC'DSKl.BSCSUP") 

in your TI BASIC ppisi^mn. The Loader loads them in the W^&mm^ '^s^ignslon Jt«iit 
and puts their names in the REF/DEF table. 

An example of the use of these utilities is given in Section 17.2.6. 



17^.1 Numertc As8ii|nmeiit~NUMASG 

This utility lets you assign a value to a numeric variable passed as an argument in the 
TI BASIC subprogram LINK. 

m^^^mmtits to a aimple numeric variable, plac^ O iB H^liii^ 0. f^i 

an assignment to an array, place the array element nunnber in Workspace Register 0. 
With OPTION BASE 0 (the default from TI BASIC) in effect, the element number 
ranges from 0 to the maximum number of elements minus 1. With OPTION BASE 1 
ft p^|C^ in effe^ tfee ete^mnt nurr^r iwtgess X te» ma^teuni 

m 





BASE. The element number for multiple dimension arrays is found by counting 
through the first elements, then the second elements, and so on. For instance, if an 
array has been defined as A(3,5^5) and the base is 0, array element AU, 2,3) is given 
in Workspace Register 0 as 1*^* f S or 51. 



a m m Ml m Workspace ^^iite h The argum|f.n| 

number gives the order of appearance of the variable in the parameter-list Qf th# 
LINK subprogram. For example, if the LINK subprogram statement is 



CALL 
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A is argument number 1 and B is argument number 2. 

The floating point variable is assigned in the Floating Point Accumulator at address 
>834A. Numbers in the Floating Point Accumulator are kept in radix 100 notation. 
See Section 17.1.3,1 for an explanation of radix 100 notation. 

The utiHiy k accessed by BLWP @HUls4ASG. for example, suppose thst TI SASC 
statement CALL LINK("PROG",A,B,C) was executed to pass control to the assembly 
language program. Then if the Floating Point Accumulator, starting at address 
>834A, contains >41 23 45 00 00 00 QQ 00, Register 0 is >00, and Register 1 is >03, 
t!hm BLWP @NUMASO ssngns m9 to C. 

As a further example, the following program segment assigns the value 5 to the third 
argument passed by the LINK subprogram. 

REF NUMASG 



FAC EQU 
NUMBER DATA 



>834A 

>4003,>0000,>OOOG,>OaOO 



LOOP 



LI 
LI 
LI 

MOV 

DEC 
JNE 
CLR 
LI 

BLWP 



R4,4 

R3,NUMBER 
R2,FAC 

*R3+,»R2+ Load floating point number 03 into FAC area. 

R4 

LOOP 
RG 
Rl,3 

©NUMASG 



Third numeric variable in list. 
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TM^ uiili^ allows a string to be assigned to a string variable passed as an argument 
in the TI aSB^Sfi^cp^iti LINK. Tfm fliM^ sUsds^f sfmce tat in Vt3f* 

RAM, copies the string into VDP RAM, and assigns the string to the selected 
variable. It then modifies the original argument stack entry to point to the new 
string. 

Before ming £rB%fv 'ff^ program must create the 6tpM^ the Mertmry 
Expansion unit with the first byte in the string giving the length of the string. Then 
the utility is called with the string address in Register 2 and the argument number in 
Register 1 as a full word. The number must be the same as it appeared in the CALL 
LINK statement. The utility is accessed by BLWP §STRASG. 

For assignmeniB %a a teiple string variable, place 0 in Wort<space Regist^ Ftar an 
assignment to an array^ place the array element number in Workspace Register 0. 
With OPTION BASE 0 (the default from TI BASIC) in effect, the element number 
ranges from 0 to the maximum number of elements minus 1. With OPTION BASE 1 
(from TI BASIC) in efffeet, the eleffjent number ranges from 1 to the maximum 
number of elements. See the USgg^ Reference Gulgfeg #ir informatior^ ^ S^PflOH 
BASL. The element number for multiple dimension arrays is found by counting 
through the first elements, then the second elements, and so on. For instance, if an 
array has been defined as A$(5,5,5) and the base is 0, then array element A$(l,2,3) is 
given in Workspace Register Qasl*6^ + 2*6#S^ il* 

For example, if your program has placed >00 in Register 0, >02 in Register 1, >C000 
in Register 2, and >02 48 49 in the addresses starting at >CO00 (where >02 is the 
number of characters in the string, >48 is the ASCII code for H, and >49 is the 
ASCII code for I), and the TI BASIC statement CALL LINK("START",A,B$»C) is 
executed, then BWLP @STRASG sete 3$ equal to HI. 



17.2.3 Get Numeric Parameter— NUMREF 

This utility alloiws you to get the valye of a numerie parameter specified in the TI 
^t^C^ ifci^ogram LINK, If the parameter is an array, Register D contains the 
element number. Otherwise, Register 0 contains 0, Register 1 contains the 
parameter number. The value of the numeric parameter is returned in the Floating 
Point Accumulator area starting at address >834A in radix 100 form. For details, see 
Section 17*2.1 on numeric assignment. The mK^^ is aeeeSSSd ^ BLWP @NUMREF. 
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17.2*4 Get String Parameter— STRREF 

This utility allows you to get the value of a string parameter specified in the TI 
BASIC subprogram LINK. If the paranneter is an array, Register 0 contains the 
element number* Otherwise, Register 0 contains 0. Register 1 contains the 
parameter number. Register 2 contains the starting address of the string In the 
MemOTy Expwislon wM, Put tim iengtti of the buffer into whit^ ym are gMm to 
read the string in the first byte of the starting address. If the string length actually 
read exceeds the number specified, an error is issued. Otherwise the actual length is 
placed in the first byte. For details, see Section 17.2.2 on string assignment. The 
Utility is Messed by BLWP @STf^EF. 

17.2.5 Error Raporting—ERR 

This utility transfers control to the error reporting routine in the TI BASIC 
interprets. The assembly language ptckgram can report any existing TI BASIC error 
or warning upon return to TI BASIC Upon return, Workspace Register 0 contains 

the error code in the most significant byte. The utility is accessed by BLWP (SERR. 
In order to obtain a meaninful error code, the Peripheral Access Block address must 
be stored at address >831C prior to the ERR call. 

The error messages that can be issued from your program are given on the next page. 
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Error 

QOii& Message 

>oi I/O emjr (mmm pEi^i^^i 

>02 I/O error (bad attribute). 

>03 I/O error (illegal operation). 

>04 1/0 error (buffer full). 

fead past: 

>07 I/O error (file error). 

>08 Memory full (closes files), 

>09 Not applicable; signifies an incorrect statement. 
Bad tag. 

>0C Duplicate definition. 

>0D Unresolved references. 

>0E Not applicable; signifies an incorrect statement. 

>ia Incorrect SlatemBnt. 

>11 Bad name. 

>12 Can't continue. 

>13 Bad value, 

>14 Number too big. 

>15 ti»Jf^*P4rnb.er mismatch. 

>17 Bad subscript. 

>18 Name conflict. 

>19 Can't do that. 

fc^ ^^fjumber, 

>1B For-nex£ error. 

>1C I/O error. 

>1D File error. 

>iE Input error. 

>1F Data error. 

>2t} Line too iofig. 

>21 Memory full (does not elose files)^ 



>22 - >FF Unknown error. 
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Note that on any error code >Q0 through >07, an I/O ERROR message is displayed on 
the screen. The ERR utility then transfers control to the Tl BASIC error-handling 
routine^ whitih reads the I/O error code toffi tt^ ^aripheral Access Block. 

17.2.6 TI BASIC UtilitiM Example 

The following program demonstrates how TI BASIC support utilities are called from 
an assembly language program. Ths Tt BA^C program file loads and runs an 

assembly language program eaUed OSKl.STRINGO. Together, these programs ^ign 
B$="HAPPY BIRTHDAY" to an array element A$(X) and display A$CX) on the screen. 
The user specifies X when the program is executing. 

The TI B^IC |3rogram loads the BSCSIF ftlit m6 fUe STRINGO and links to the 
fai^gMh G»ltea STRINGc Tl BASIC JMs &0mmm X, and A$0 to im pes^ 
in the CALL LINK statement. Before transferring control to the assembly language 
program) it prompts for the element number X. 

The assembly language program smSNG reads the eleinant rmmber X, reads the 
string B$, and as^glis B$ to the aciNiy alament A$(X). Since Workspace Register 11 
was not altered by this program, the RT instruction can be used to return to TI 
BASIC. 

The TI BASIC program then displays A$(X), which is HAPPY BIRTHDAY, on the 
screen. 

100 DIM A$(15) 

110 B$ = "HAPPY BIRTHDAY" 

120 CALL INIT 

150 CALL LQAD("DSK1.BSCSLP","DSK2.TRY") 

140 INPUT "ELEIs^NT NLIvBER?"iX 

150 IF X>15 THEN 140 

160 CALL LIN<( "STRING", X, 8$, A$( )) 

170 PRINT A$(X) 

180 iND 
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DET STRING 

RET STRREF,STRASG,NUMREF 



FAC 
* 

BUFFER 



EQU 

BYTE 
BSS 



>834A 

>1F 
>1F 



STRING 



CLR 
LI 

BLWP 



HQ 
Rl,l 

(aiNUMREF 



Read numeric value X. 



MOV 
ANDI 



RS^ODFF Keep the element number. 



CLR 

LI 

U 

BLWP 



RO 
Rl,2 

R2,BUFFER 
@StRREF 



Second argument B$. 
Points to the buffer area. 
Read in the string value^ 



MOV 

LI 

LI 

BLWP 



R5,R0 
Rl,3 

R2,BUFFER 
eSTRASG 



Element number. 

Assign the string to A$(X). 



RT 
END 
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SECTION 18: FILE MANAGEMENT 



With assembly language, you can control the way in which files are accessed* This 
section describes the file management system as it is provided. By making 
appropriate changes, you can construct your own system to interface with devices in 
o£her waysk 

The file management system regards all devices (except the screen and keyboard) as 
identical. Different Device Service Routines (DSRs) are used for different devices, 
but they all appear the same to the assembly language programmer. They support 
both random access and sequential files, and files with records of both fixed and 
variable length. The following sections describe the way in which you access the 
DSRs. 

18.1 FILE CHARACTERISTICS 

A file consists of a GoUac^'on of data ^mii^gs called logical reoords. These reccu'dB 
do not necessarily correspOfKl With the the physical cttvlslons of the data in the file. 
For example, a logical record often does not correspond to a sector on a diskette. 
File input and output (I/O) are done on a logical record basis. Manipulation of 
physical records is handled by the D6R. 

The records on sequential files can only be read from, or written to, in sequential 
order. This is appropriate for printers, modems, cassettes, and some kinds of data 
files. The records on sequential files can be of either fixed or variable length. 

T^ records on relative filee can be read from, or wt'itten to, in either sequential 
order or in random order. You can only use relative files on diskettes. The records 
on relative files are of fixed length. 

Eadi record on a file has a number from zero up to one less than the number of 
records in the file. You use these record numbers to speoify which record to access 
on relative filesw 

When a file is created, its characteristics must be defined. Most of these 
characteristics cannot be changed later in the file's existence. The characteristics of 
files are discussed below. 
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18.1.1 File Type— DISPLAY or INTERNAL 

'S^i^m^ specifies the format of the data in the fiie. 

m DISPLAY sets the file type to contain displayable or printable eh^BGtMt 
strings. Each data record corresponds to one print line* 

i INTERNAL sets the file type e^f^^ data in Internal machine format. 

The file type attribute is not significant to tflfi IXR» It is merely passed Oh without 
affecting the actual data stored- 

iB-1.2 Moiiis a* c^»ation— iNRurr^ miTPUT, upomm, m append 

A file is opened for a specific tnode of operation. 

• INPUT specifies that the contents of the file can be read from but not written 
to. 

• OUTPUT specifieG that the file is belri§ itJiPeated. Its contents can be Writ^t^n 
to but not read from. 

• UPDATE specifies thaf Ifee^ contents of the file can be written to and 
rdad from* 

• APPEND specifies that data can be added to the end of the file but data 
cannot be read, 

Tm DSR tjetermines whether a specific fo^ an I/O operation can be aiE^^d^ 

by the given device. Tpr example, the Tt Thermal Prmfeer can only be opened in 
OUTPUT mode. 



EDITOR/ ASSEMBLER 



FILE MAWPEJN^W 



18.2 PERIPHERAL ACCESS BLOCK (PAB) DEFINITION 

DSRs ere accessed thmigh a Pis^Slillei^ Access Block (PAB). The format of the PAB 
la the mmm itsp every p«>i|j(^^ lii a ^^c^^0i &mt you write, the cmly diffi^m^ 
between peripherals is that some of them do not allow every option provided for in 
the PAB. An example of using a PAB is given in Section 18,3. 

The mm in VDP RAM. They alrfe er^M before mr\ OPEN j^ttament are 
not released until the I/O for their corresponding peripheral has been closed. 

The following describes the bytes which make up a PAB. 



Bytli Bit Ooni^ntat Meaning 

0 All I/O Op-code The op-code for the current I/O call. See 

Section 18.2.1 for a description of the op-codes. 



All Flag/Status 



0-2 Error code 



3 f^ecord type 

4 Datatype 
5,6 Mode of 

operation 
7 File type 

All Data Buffer 
Address 



All information the system needs about the file 

type, mode of operation, and data type. The 

meaning of the bits is described below. 

No error is 0, Other errors are indicated in 

combination with the I/O op-code. The error 

codes are discussed in Section 18.2.2. 

*<Fked Idngth re^tird^ ara 0 and "variable length 

records" are 1. 

DISPLAY is 0 and INTERNAL is 1. 

UPDATE is 00, OUTPUT is 01, INPUT is 10, and 

APPEND is 11. 

"Sequential file" is 0 and "relative file" is 1. 

The address of the data buffer that the data 
must be written to or read from in VDP memory. 



AU Logical Record 
Length 



The logical record length for fixed length 
records or the maximum length for a variable 
length record. 



All Character The number of characters to be transferred 

Count for a WRITE op-code or the number of bytes 

actuary read for a READ op-code. 
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Byte Bit Contents Meaning 

6*7 All Record Number (Only required for a relative record type file.) 

The recorcl numtsar dm which 
□peratte U 

is ignored, s& this number ean be from 0 throuigh 
32767. 




8 



All abr« 



Tfiii^ Effif^ the screen characters v^»* 
to theJr normal iWBlfe* I 

by the cassette interface. Which must put prompts^^ 
on the screen. 



9 All Name Length The length of the file descriptor, which starts in 

byte ID. 



ID* Ail File 

Descriptor 



The device name and, if required, the filename 
and options. The length of this descriptor is 
given in byte 9. 



The foilowing figure summarizes the bytes which make up a PAB. 



0 

I/O op-code 


1 1 

1 Fl ag/S ta t us 


2,3 

Data Buffer Address 


4 

Logical Re cord Leng th 


1 5 

1 Character Count 


6,7 

Record Number 


3 

Screen Offset 


1 9 

1 Name Length 



10+ 

File Descriptor 



Errors that occur in input/output calls are returned in byte 1 (Flag/Status) of ' 
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18.2.1 Input/OutfMJt Qp-codes 

The following describes the op-codes which can be used in byte 0 (I/O Op-code) of 



18,2.1.1 OPEN— 0 

The OPEN operation must be performed before any data-transfer operation except 
thofliB perfoipm^d with LOAD or SAVE. The file remains open until a CLOSE 
operation is performed. The mode of operation must be given in byt© 1 tFla0/SltSfeus} 
of the PAB. Changing the mode of operation after an OPEN causes unpredictable 
results. 

If a record length of 0 is ^ven In byle 4 ^dglcal fiemGtti Length) of the PA3f tNi 
assignetl mmr^ langth i^ith m t\m peripheral) is returned in byte 4. If a 

non-zero record length is given, it is used after being checked for correctness with 
the given peripheral. 



18.2.1.2 CLOSE— 1 

The CLOSE operation closes the file. If the file was opened in OUTPUT or APPEND 
mode, an End of File (EOF) record is written to the device or file before closing the 

file* 

After the CLOSE operation, you can use the space allocated for the PAB for other 
purposes. 



18.2.1.3 READ— 2 

The READ operation reads a record from the selected device and copies the bytes 
into the buffer specified in bytes 2 and 3 (Data Buffer Address) of the PAB. The 
Mze of l*ie buffer is specified in byte 4 (Logical Record Length) of the PAB. The 
actual number of bytes stored Is specified in byte 5 (Charactra- Count) of tSiw PABw 
If the length of the input record exceeds the buffer size, the remaining characters 
are discarded. 
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18.2.1-4 WRITE— 3 

The W^TE operation writes a record from the buffer specified in bytes 2 and 3 

iW^^ Addre^ ^ Use PAfi, The number of bytes to be written is specifi^^ in 
mt& 3 itmmcWP count) of the PAB. 



The RESTORE/REWIND operation repositions tbas read/write pointer to the 
beginning of the file or, in the case of a relative t^B^rd file, to the record specified 
in bytes 6 and 7 (Record Number) of the PAB. 



The RESTORE/FiEWIND operation can only be used if the file was opened in INPUT 
m- tWI^P^ mEde, For reiafeta isessEd f^ES^ ysu can sinnulate a RESTGff^ ^ mny 
jttode by specifying the record at which the file is to be positioned in hytes 6 and 7 
(Record Number) of the PAB. The next operation then uses the indicated record. 



The LOAD operation loads a memory iniaye of a file from an external device or file 
into VDP RAM. The LOAD operation is used without a previous OPEN operation. 
Mmn ^ U#i^l^ ^g^ltion requires as much buffer in VDP m the ^ 

QcGupies on the diskette op other device. 

For a LOAD operation, the PAB needs the op-code in byte 0 (I/O Op-code), the 
starting address of the VDP RAM memory area into which the file is to be copied in 
bytes 2 and 3 (Data Buffer Address), the maximum number of bytes to be loaded in 
bytea 6 and 7 (Record Number), the name length in byte 9 CNanrre Length), and the 
fUe deaeriptor information in bytes li3+ (File Descriptor)* 

For related information, see the explanation of the RUN PROGRAM FILE option from 
the Editor/Assembler selection list in Section 2.3. 
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18.2-1.7 SAVE— 6 

The SAVE operation writes a file from VDP RAM to a peripheral. The SAVE 
operation is used without a previous OPEN operation. Note that the SAVE operation 
copies the entire memory im^e from the buffer in VDP RAM to ttm 4i8l<ette or 
oth^ device. 

For a SAVE operation, the PAB needs the op-code in byte 0 (I/O Op-code), the 
starting address of the VDP RAM memory area from which the file is to be copied in 
bytes 2 and 3 (Data Buffer Address), the number of bytes to be saved in bytes 6 and 
7 (Record Number), the name length in byte 9 (Name Length), and the file descriptor 
information in bytes 10+ (File Descriptor). 

For related information, see the explanation of the SAVE utility in Section 24.3. 

18.2.1.8 DELETE—? 

The DELETE operation deletes the file from the peripheral. The operation also 
performs a CLOSE. 

18.2.1.9 SCRATCH RECORD-« 

The SCRATCH RECORD operation removes the record specified in bytes 6 and 7 
{HeecH?d Number) from the specified relative record file. This operation causes an 
error for peripherals opened as sequential files. 

18.2.1.10 STATUS--9 

The status is in byte 8 (Screen Offset) of the PAB. The status byte returns the 
status of a peripheral ar^ odrt b9 mmiinmi at uny tSmek nf th6 Utn have 

meaning if the file is currently open. Bits 6 and 7 only have meaning for files that 
are currently open. Otherwise, they are reset. The bits return the information 
shown on the next page. 
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Bit Information 

i If set, the file does not exist. If reset, the file does exist. On some 
tlevi:e«^ as m ^tef*^ this bit is never set since any file could exist. 

1 If mt, tfm file Is prSteGted agsun^ modification. If reset, the file is not 
protected. 

2 Reserved for possible future use. Fixed to 0 by the current peripherals. 

3 If set, the data type is INTERNAL. If reset, the data type is DISPLAY or 
the fil0 is a fffogram file. 

i| W the file i« 0 fJlKJgram file, ff 3^^^ ^ is a datw ^1^* 

5 If set, the record length is VARIABLE. If reset, the reGord length is 
FIXED. 

6 If set, the file is at the physical end of the peripheral and no more data can 

7 If 'mk, 'Wm. h md of its pi^m^ f^^&m^ mnttm^ Ifm M 

still write to the file (if it was opened in APPEND, OUTPUT, or UPDATE 
mode), but any attempt to read data from the file causes an errsF. 



1B.Z.2 EiTor Codes 

Errors are indicated in bits 0 through 2 of byte 1 (Flag/Status) of the PAB. An error 
code of 0 indicates that no error has occurred. However, an error code of D with the 
COND bit (bit 2) set in the STATUS byte at address >837C indicates a bad device 
name. 

The table on the following page sihows the possible error codes and their meanings- 
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Code Meaning 

0 Bad device name. 

1 Device is write protected. 

2 Bad open attHlt»ti£^ such as incorrect file type, incorrect record len^» 
incorrect I/O mode, w no records in a relative^ ^jord fU«u 

3 Illegal operation; i.e., an operation not supported on the peripheral or a 

conflict with the OPEN attributes. 

4 Out of table or buffer space on the device. 

5 Attempt to read past the end of file. When this error occurs, the file is 
closed. Also given for non-extant records in a relative record file. 

6 Device error* Covers all hard device errors such as parity and bad 

medium errors. 

7 File error such as program/data file mismatch, non-existing file opened in 
INPUT mode, etc. 



18.2.3 Device Service Routine Operations 

Device Service Routines (DSRs) react in specific ways to various operations and 
condition^ The^e reac^tom described in the following sections. 

18.2.3.1 Error Conditions 

If a non-existent DSR is called, the File Management System returns with the COND 
bit (bit 2) set in the STATLS at address >837C. 

If the DSR detects an error, it indicates the error In bits 0 through 2 of byte I of 
the PAB. Therefore, your assembly language program must clear these bits before 
every I/O op&a^tm and ctmck them after every I/O operatitm. 

18.2.3^ Special Input/Output Modes 

The DSR uses only the first part of the file descriptor in its search for the requested 
|^^i)?heral. The remainder of the descriptor can be used to indicate special 
device-^related functions such as teansmisaion rate, print width, etc. The DSR Ignores 
descriptor portions that it does not recognize. 
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An example of a special I/O mode descriptor that sets values for the RS232 Interface 



RgZ32.MUDRATEsi2:m.DATABlTSp?,CHlCKPAI^lTY,PARItY^ODD 
18.Z.3.3 Default Handling 

Tt^ DBH. has certain ctefaults that are ysed if m valu&g am speclfiect. the fallowing 
^o.W9 these defaults. 



18.2.4 Memory Requirements 

til© Il« mm ^fl^^ms- U tWm^ 10 laf ^ i^lfc^ Wj^kspace and addresses >834A 



through >a36D. If the DSR is called irV s fij^JE^rupt driven mode (for example, 
through a standard DSR entry), addresses ^^E^k ttirough >83DF are used. Also used 
are PAD (See Section 24.3.1) and VDP RA^. 



18-2.5 Linkage to TI BASIC 

When using TI BASIC, the PAB is modified by the addition of four bytes at the 
beginning of the PAB. The list on the next page describ?©® !*^ fejfl^l^- «^5tSt^ iP^I^ 
a PAB when il ^ rted from TI BASZC 



Possibilities 

Sequential or relative 

UPDATE, OUTPUT, INPUT, or APPEND 

DISPLAY or INTEKAL 
Fixed or variable length 



Sequential, 



UPDATE. 
DISPLAY. 



LaglQal record length 



Fixed if relative and variable If 
sequential. 

Depends on the ^ecific periphepaL 
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Byte Contents Meaning 

0,1 Link tP ne;^t PAB The address of the next PAB in the chain of PABs used 

by TI BASIC, The last PAB in the chain has a value 
of >00Q0 in these bytes. 



Internal Offset 



The number assigned to; the file by TI BASIC. 

If 0, there is no effect. If non-zero, it is the value to 
be added to the start address of th^ i^fet buffer b^^teB 

(;) or comma (,) or if the 
end^Ci In a pomma (,). 



6,7 



Data Buffer 
Address 



Harpi! as byte 1 in the PAB described in SeGtran 18.1. 
Same as bytes 2,3 in the PAB described in Section 



B Logical R^is0rd Same aabyte ^ in tM FM desei^ifeed im BmtiUn 

Length 18.2, 

i Character Count Same as byte 5 in the PAB described in Section 18.2. 



3JD(ll Re0ord Nwmbier 



Same gsi; feyte^ in th®: dt^;S|»fd in Stplion 



12 Screen Offset Same as byte 8 in the PAB described in Section 18.2. 

IJ Name L^g£h Same as byte ^ In the PPM ^desmib&i in S^gctfen IBM, 

14+ File Descriptor Same as b.ytes 10+ in the PAB described in Se.ctipn 

18.2. 
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0,1 

Link to next PAB 


2 

File NurE^^i$ 


1 3 

I iptjeraa^i Qff set 


4 

I/O Op-code 


1 5 

1 Flag/Status 


6,7 

Data Buffer Address 


8 

Logical Record Length 


1 9 

1 Character Count 


10,11 
Record Number 


12 

Screen Offset 


1 13 

1 Name Length 



+ 

I 14+ 

I File Descriptor 



The following shows how three PABs might be linked in TI BASIC. 



<^CPU RAM-> VDP Rm > 

> B 5 >C > OFAB > 0E2 7 > QDl A 

I OFAB I --> I mm I --> i ODIA ! --> I 0000 I 
+ + , + + , + + + 

I 04 I -- I I 01 I I 1 2A I I 

+ + + + + + 

i PAB #1 I I PAB #2 I I PAB #3 I 



FILE MANAGEMENT 



18*3 EXAMPLE OF FILE ACCESS 

The following program opens a fixed 80 file called DSKl.DATA, reads a record from 
it, waits for you to £:lt»M tiie ^e, and returns to the QaHlng prografn« 



DEF 
REF 



DSR 

DSRLNK,VMBW,VMBR,VSBW,KSCAN 



w 

PABaUF 
PAS 

STATUS 

PNTR 
« 

SAVRTN 
PDATA 



READ 
CLOSE 

MYREG 
BUFFER 
« 



EQU 

EQU 
EQU 

DATA 
DATA 

TEXT 
EVEN 
BYTE 
BYTE 

BBS 
BSS 

MOV 

LWPI 

LI 

LI 

LI 

BLWP 



>F80 

>837C 
>8356 

Q 

>0DO4,PABBUF,>5O0O,>0OOO,>00a9 
»DSK1.DATA» 

>Q2 

m 

>20 
80 



Load own registers. 



M[¥Rte 

RO,PAB 

RljPDATA 

R2,>20 

(aVMBW 



Move PAB data into PAB in VDP RAM, 



LI 

MOV 

BLWP 
DATA 



R6,PAB+9 
R6^PNTR 

§DSRLNK 
8 



Pointer to name length. 

Store pointer to name length in >6356. 

Open file. 



MOVB 
LI 

BLWP 



[aREAD,Rl 

RO,PAB 

SIVSBW 



Change I/O op-code to read. 
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BLWP 
DATA 

LI 
LI 

LI 

BLWP 

LI 
LI 
LI 

BLWP 

* 

LOOP 

BLWP 

MOVB 

JEQ 

OVER MOVB 
LI 

BLWP 

MOV 

BLWP 

DATA 

CLR 
MOVB 
MOV 
RT 

END 



(iDSRLNK 
8 

ROjPABBUF 
R1,BUFFER 

R2,80 
(aVMBR 

R0,>1Q2 
R1,BUFFER 
R2,80 
PVMBW 



@5TATUS,R0 
LOOP 

(iCLOSE,Rl 

RO,PAB 

§VSBW 

R6,§PNTR 
©DSRLNK 
8 

RO 

ROj^STATUS 
@SAVRTN,R11 



f^fflsste-e jaointer to name. 
Read one record. 

Move to CPU buffer. 

Specify beginning screen location. 

Move line to screen. 

W&tt for key press. 

Change I/O op-code to close. 

Restore pointer to name. 
Close file. 

So that no error is reported. 
Saved return address. 
Return to calLlng routine. 
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The Linking Loader loads assembly language programs into the Memory Expansion 
unit. The Loader is written in assembly ^&it^s^gi and is included iri the Utility 
programs in ^^Im^iMmmMes ^ffi^tsnitfid Madtrife. Sirt^ eompressed and 
uncrampressed tagged ofeject code can be handled by the Loader. 

The Loader is loaded into the Memory Expan^lpn unit as part of the utility programs 
when you M^et Iftt LIW© MM ftp^ &m ^^i^fPmmmi^ mMm^. ttM 



^ k TC TOSIC ^eij^^ IHtf a^t^^^6r^t. It is Wm Imc^ 



the first time CALL LOAD is executed without the Loader in memory. The utility 
programs are loaded in the lower block of memory, starting at address >2000, in the 
Memory Expansion unit. 

19*1 MEMORY ALLOCATION 

The Loader always attempts to load relocatable programs into the 24K block of high 
memory located in the Memory Expansion unit at addresses >A000 through >FFD1# If 
insufficient space is there, the Load^ pliaiSes the |3f««^ram betv^^tt l^ie utilities and 
the REF/DEF table in the low memory of the Memory Expansion unit at 
approximately addresses >2676 through >3F37. 

When a 0-tag (see Section 15.2 for a description of tags) is encountered, and high 
memory has endiigh spat^, the starting load address is updated from the First Free 
Address in High memory (FSTHI, equal to UTLTAB+2 or address >20Z4), and the 
module length is added to F5THL 

if the high memory is full or has insufficient space to allocate the program, the 
Loader checks the low memory. If sufficient space is there, the starting load 
address is upt^M ftrom the First Free A^in^ ftl km mmf^ f STLOW, equal to 
UTLTAB+6 or address >202B) and the module length is added to FSTLOW. 

Loading absolute code does not affect these memory pointers. Thus, loading 
l^l^^tWt i0tW ita^l^ c^xie ham b@en teied nrnf ^Bom kim a^s&hm fm4B to^ 
be overwritten. Simileurly, loading absolute code after relocatable code may 
overwrite the relocatable code. 
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The Loader can be called repeatedly to load more than one file until both high and 
liJW nnemory are full. The programs that have been loaded are aceessible untU one of 
the following conditions oDCurs^ 

• The EDIT, LOAD, or SAVE option is selected from the Editor/ Assembler 
selection list, causing the Editor to be loaded into memory. 

m Ttm ^^i^m is selected f mm &m M^it/ Assembler selection list and 

the. Assembler program is loaded into rhembry; 

• The LOAD AND RUN option is selected from the Editor/Assembler selection 
Ust and ttm mw 1& ^ifeire^ 

• The RUN PROGRAM FILE option is selected from the Editor/Assembler 
selection list, and a program file is loaded into memory. 

• CALL INIT is executed from TI BASIC. 

• An error occurs when leading a program* Then all previous loads are invaKd, 
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19.2 THE REF/DEF TABLE 

The object tags generated by DEF statements (5- and 6-tags— see Section 15.2.1 for 
more information on tags) define locations in a program that can be referenced by 
other routines. Additionally, they can define assembly language programs which carl 
be m^Wi W from the LOAD AND RUN tar RUN options on the 



Et^itor/Asaembler selection list or from the CALL LINK statement from TI BASIC. 

If the entry point is specified in the label field of an END statement (tag 1 or 2), the 
Loader branches to the entry address and starts execution without returning to the 
Editor/Assembler. In this case, the screen is Eleared or changed in color, so 



tfm mtmti specifying a 9Qimn ©alteff is your i'^^;^^ibility. Also, the 
Workspace Registers at USRW5 are not loaded, so you must load USRWS OT your o\yn 
Workspace Registers with the LWPI instruction. 

TfiB and 6-tags corti^n m& mxm ^^mm^ tfm mm mmmmn mii %■ 

instruction. These names and addresses are placed in the REF/DEF table starting at 
the highest address in low memory (>3FFF) and going toward >3000. Each entry is 
eight bytes, six for the ASCII name and two for the address. Some REFs and DEFs 
are predefined and are placed in the REF/DEF table when the Loader is placed in 
memory. The REF/DEF table entries for your programs normally start at >3F38 and 
go towaid >5000 from there. Each time an item is added to the REF/DEF table, the 
pointer to the Last Free Address in Low Memory (LSTLOW, equal to UTLTAB+8 or 
address >202A) is adjusted. 

The Loader also resolves REFs in your programs. Any DEFed symbol can be REFed in 

pfe^e^tiiyn. REFed Symbols are Stored in the REF/DEF table in the same way as 
DEFed symbols. To distinguish a REF entry from a DEF entry, the first word of REF 
entries is in two*s-complement form. 

REFs are resolved and deleted from the table as soon as the corresponding DEF is 
found. DEFs remain until the mft% ¥mn t^e utilities w fep^^t «s*ilch resets the 
nriemory pointers. 

The following list gives the predefined symbols for which the Loader resolves 
references. The address is the address to which the symbols are equated. An error 
occurs when the program is executed if a reference is never defined with the DEF 
instruction. T^ use of these symbols is described in Section 16. 
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UTLTAB 


>2022 


PAD 


>8300 


GPLWS 


>83ED 




moo 


VDPSTA 


>8802 


VDPWD 


>8C00 


SPCHRD 


>9000 


SPCHWT 


>940a 


GRMRD 


>98D0 


GRMRA 


>9a02 


GRMWD 


>9C00 


GRMWA 


>9CQ2 


SCAN 


>OQQE 




Start of the utility variable table. 
Start of CPU scratch pad RAM. 
GPL interpreter workspace painter. 

i^ip register. 

f^m^ tmrn Register^ 

VDP Read Status Register. 

VDP RAM Write Address Register. 

Speech Read Data Register. 

Speech Write Data Register. 

GROM/GRAM Read Data Re^fSE^. 

GRQM/GRAM Read Address Register. 

GROM/GRAM Write Data Register. 

GROM/GRAM Write Address Register, 

Address of branch to the keyboard scan utility (KSCAN). 



The following list gives the Utilities, also discussed in Section 16, for which the 
Loader resolves references. 



Name 

VSBW 

VMBW 
VSBR 



VWTR 

KSCAN 

GPLLNK 

XMLLNK 

DSRLNK 
LOADER 



Writes a single byte to VDP RAM. 
Writes multiple bytes to VDP RAM. 
Reads a single byte from VDP RAM. 

nmM mump^ mm ¥t3p wm^ 

Writes a single byte to a VDP Register. 
Scans the keyboard. 

Links your program to Graphics Programming Language routines. 
Links your program to the assembly language routines in the console 
ROM or RAM- 

Lirtks ySft^ ^fi^am to Device Servile RiouEines, 

Links your program to the Loader to load TMS9900 tagged object 

code. 
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19.5 OBJECT TAGS 

Object format tags are created in object code when your assembly language code is 
assembled. The tags provide the Loader with the information it needs to load ths 
object code. All tags 0 through 9 and A through I, with the exception ©f 1^ 
and H, can be used by Wm Loader. Any other tags cause theL^td^ ^ ^p with an 
error. In addition, the colon (:) as the first character in a record signifies the end of 
the file. The actions taken for each of the object format tags are described below. 
For a further discussion of object format tags, see Section 15.2. 



Code Name 



0 



Module ID 



Actions 

The First Free Address pointer is placed in the relocation 
base register and the load address register. The module 
length is added to the First Free Address pointer. The 
module name is ignored. 



1,2 Entry A value of 1 indicates an absolute entry address. A value 

Address of 2 indicates a relocatable entry address. One of these 

tags may appear at the end of the object code file by 
specifying an etmf |Sdint with an END in your asset!f||ijl|f 
lan@E)»ge l^a^ws. The Loader immediately executes soy 
object code starting with one of these tags. 



3,4 External A value of 3 indicates that the symbol is in relocatable 

code. The REFed symbol is plac^ la th0 B^^^E^ imH& 
with the address of the symbol (plus the relocation base If 
the tag is 3). The entry is deleted from the table when the 
corresponding DEF is found. The first word of the 
reference Is given in two's-complement notation. 



5>6 External A value of 5 indicates that the symbol is in relocatable 

Definitions code. A value of 6 indicates that the symbol is in absolute 
code. The DEFed symbol is placed in the REF/DEF table 
with the address of the symbol (plus the relocation base if 

the tm U 5). 



Record 
Checksum 



The checksum Is tested witli the cmputed value. 
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Code Name 



Actidns 



B Igntred The value field is ignored* 

Checksum 

9 Absolute The value is placed in the current address register. 
LM0 Address 

A Relocatable The value plus the relocation base register is placed in 

Load Address the current address register. 



B 



Absolute 
Data 



Relocatable 
Data 



The data is placed at the address specified by 
current address register. The current address is 
incremented by 2* 

The value of the data plus the relocation base register 
placed at the address specified by the current address 
register. The current address is incremented by 2. 



D 

E 
F 



Load Bias Loading halts with an error. 



Undefined Loading halts with an error. 



End 4f 
Record 



The rest of the record is ignored and a new record is 
read. 



G,H Undefined Loading halts with an error. 

I Program Ignored. 
Segment JD 



End of File When the first character of a record, loading halts. 
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Note: When absolute code is loaded if#0 memory, free space pdintw^s are not 
updated or checked against the size of itie pr^esgE^m* Thus, the Loader does not i^ue 
an ei^ror mes^e^ if the pr^am overwrites a utility program (including the Loader 
itself) or does not fit in memory. When loading a short program by poking data into 
memory, the same situation occurs. To run the poked program, you must modify the 
REF/DEF table by adding a DEFed entry for the program* t%avt^ hfiil^f to 
Lo&iM Vgm^^^ m^ftmfi the free space address pointer should bm jgwIJLsiM aa that 
the Loader does not load a program into an area where an AORGed or poked program 
is located. The TI BASIC subroutine PEEK can be used to read the pointers before 
they are modified. See Section 17.1.4 for more information, 

19»>.l Loader Error Codes 

If no error occurs, the second bit in the STATUS byte at >837C is reset on return 
from the Loader, If an I/O or loading error ocurs, the status bit is set. The 
following are the error codes used. 



Code 


Meaning 


D-7 


Standard I/O errors. 


8 


Mrnn^ overflow. 


9 


Not used. 


10 


Illegal 


11 


Checksum error. 


12 


Unresolved reference. 



Note: If the Loader finds a label in the DEF statement that is already defined in 
the REF/DEF table, a duplicate definition error is issued and loading stops^ 
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With the TI Home Computer, your program can generate up to three tones, with a 
range of 110 to 55,938 Hz, and one noise, Sound generation involves setting the 
ftmg^^^ the tone or the type of noise desired, settinf IfMS volume dp attenuation, 
setting the duration of the tone or noise, and then starting the sound. Sound is 
generated using the TMS9919 Sound Generator Controller. 

Three addresses in CPU RAM are associated with processing sound information. You 
place a pointer to the sound table in VDP RAM at address >83CC. You place >01 at 
;®ilto9® 3^1^ to start the proes^i^g Of Wm mmi geia©aa*OF* This address is used 
by the interrupt routine as a count-down timer during the execution of sound. The 
least-significant bit of the byte at address >87>fD (whicti is the least-significant byte 
of GPL Workspace Register 14) must be set to indicate that the sound table is in VDP 

The VDP interrupt must be disabled while you are setting up memory for sound 
operation. Normally the VDP interrupt is disabled when control is trafmfeired to 
your assembly language program. If necessary, you can disable the VDP interrupt 
with the LIMI 0 instruction. After the memory has been set up, you must enable 
VDP interrupt with the LIMI 2 instruction in order to start processing sound 
operation. 

Note: Interrupts should never be enabled while your program is accessing VDP 
memory because the interrupt routines can change the VDP read iwrffee a«iEfir>esssfiSw 
To execute sound lists automatically, you must enable interrupts momentarily at least 
^xtieth of a second If your pvognm^rCi has a key scanning loop, such as the one 
shown belowf that is often a good place to enable interrupts. 



GETKEY LIMI 2 Test for interrupt, 

LIMI 0 

BLWP S^SCAN 

MOVB (i>837C,0 

JEQ GETKEY 
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20.1 SOUND TABLE 



You must construct a sound table in order to create sounds. The sound table consists 
of sound lists, each of which provides the information necessary for the operation of 
the sound processor. For a tone, the infornnation consists of the register value and 

mm far f requericy mum^^m.. ¥m ^ i^iise, m& i^memitmi' mt^m If m rmm 

source and attenuallsRi ¥©nses can fee ^^Ified, singly or in combi nation, fiSr 
generator 1, 2, or 3. Noise can be specified by a noise generator. 

When you are generating tones, the first byte in the sound list is the number of bytes 
to be loaded into the sound processor. Following that are the bytes to be loaded. ^ 
generator and frequency can be specified by two bytes. A generator and attenuation 
can be specified by one byte. A generator and noise can be specified by one byte. 
After you give all generator, tone, noise, and attenuation specifications, you give a 
duration time. A sound list consists of a series of these specifications. Each 
speclflDstion consists of a byte count, a series of generator, tone, noise, and 
attenuation 8pecificati0f% Mihd ^ duration time. 

The two bytes that specify the tone information contain the following. 



Byte Bit Contents 

1 0 1. 

4-7 Four least significant frequency bits, 

2 0 - 1 00. 

2^7 Six most significant frequency bits. 

The byte that specifies attenuation information contains the following. 



Byte Bit Contents 

1 0 U 

1 1-3 Operation^ 

1 4-7 Attenuation. 
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The byte that specifies noise information contains the following. 





0t 


1 


0 


1 


1 


1 


4 


1 


% 


a 


6 



1. 

- 3 Operation, 

0. 

White noise or periodic noise. 

- 7 Type of noise. 



20.1.1 Operation Specification 

The opemUmm mrm ^mri^k^ in bit* 1 ^rrni^ 5 of 1. 



Operation 


Significance 


0 0 


0 


Tone 1 frequency 


0 0 


1 


Tone 1 attenuation 


0 1 


Q 


Tone 2 frequency 


□ 1 


1 


Tone 2 attenuation 


I 0 


0 


Tone 3 frequency 


1 0 


1 


Tone 3 attenuation 


1 1 


0 


Noise control 


1 1 


1 


Noise attenuation 



20.1.2 Froquency Specification 

The frequency value required in the Sound Table is contained in bits 2 through 7 of 
byte 2 and bits 4 through 7 of byte 1 of the bytes w^^^lx^ 'iF0mn^0%. JWM 
sil^Gm ^ m^m ©f torn £K( WMQ Wm ttwu#i ll llll llll through >m^ T» 
value, which is kept in the period register, defines half of the period of the desired 
frequency, N. The value is loaded into a 10-stage tone counter which is decremented 
at a rate equal to n/16, where n is the standard input clock frequency, 3.579545 MHz. 
When 1^ lone counter decremeTits to zero, a borrow signal is produced. This borrow 
signal ^Ule® &m tmE^etmy flip-flop and reloads the tone counter. Thus, the period 
qf the desired frequency is twice the value of the period register. 
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Tffe frequency % is ito V^H, Ttie i^ate is specified so ^at fche 

value of K 5s equal to liJiiiiii&*a te^^Aess of the input ^Iw^ frequency. Thus, f = 
illB60.8/H can always be used to calculate the frequency code. The lowest possible 
frequency is ilO Hz, and the highest is 55,938 Hz. 

Far example, to output a feequency of 110 Hz, f = 111,860.8/110 or appro^elWia^y 
1017 C>3F9 or 11 1111 lODl blTwy># Macing this value into the cj^we^ positions 
(most significant six bits in bits 2 through 7 of byte 2 and least significant four bits 
in bits 4 through 7 of byte 1), adding an operation description of 000 in bits 1 through 
3 of byte 1 to specify a frequency for generator 1, and putting in the required bit 
values gives the correct byte values. They are 1000 1001 (>89) in byte 1 and 0011 
1111 (>3F) in byte 2. 

20.1*3 Attenuation Specification 

The attenuation can be from 0 to 29 DB. In addition, the generatar can be mad© 
silent by ^m^^lnt the maxiirM attenuation. The E^^wfete ti ^^^StlM M Mt^ 4 
through 7 ol the byte specifying attenuation. In determining the attenuation, these 
four bits may be regarded as having a binary 0 after them. Thus, a value of 0001 
may be considered as OOOiO, or an attenuation of 2 DB. A value of 0110 may be 
considered as QllOO, or an attenuation of 12 DB, Setting nil th# ^ 
of 1111, turns the sound generator off. 

For example, to turn off generator 1, data 1001 1111 (>9F) is placed in the byte. To 
put an attenuation of 0 DB in the noise generator, data 1111 0000 (>F0) is placed in 
t3?0 byte. 

20*1«4 Noise Specification 

The iliQise generator consists of a noise source and an attenuate. The mise ^toise im 
a 15-8tage shift register wi^ an exclusive OR feedback netvi^ork. The feedback 
network has provisions to protect the shift register from being locked in the zero 
state. 

The feedback network has two feedback tap configurations as determined by bit 5. 
If bit 5 is Ov tSS noise is of the periodic type. If bit 3 is 1, white noise resultSi, 
(See the User's Reference Guide for more information on white noise and periodie 
noise.) When bit 5 is changed, the shift register is cleared. 
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The re^^^ aMfts mm 0f fw mt&s as determined by bits 6 and 7. ftx«d 
shift i^t^ am ^tel^i^ torn the input clock, which has a frequwmy^ ti, &f 
MHz. A value of 00 specifies a shift rate of n/512 or 6991. A value of 01 specifies 
a shift rate of n/1024 or 3496, and a value of 10 specifies a shift rate of n/2048 or 
1738. With a value of 11, you can define the shift rate by feeding the shift rate into 
generator 3. 

For example, to produce a white noise with a ^ift rate of 1748, data 1111 0110 OFfi) 
must be placed in the byte. 



20.1.5 Duration Control 

After the byte giving the number of specification bytes to be loaded and the 
specifications are entered, a byte which controls the duration of the sound is given. 
This byte specifies the length in sixtieths of a second. It can range from >00 (no 
time, iMfh ^^»Ss !&m ^Kieffatel teefU^ >FF (approximat^J^ 4^ seconds). 

For example, to specify a tone with a frequency of 110 Hz and 2 DB of attenuation 
for 0.5 seconds on generator 1, the bytes to load are >03, >89, >3F, >91, >1E. The 
first byte (>03) specifies that there are three data bytes to load into the sound 

^ij^wm^ei Ttee mtt tmu ^WW) specify m t»t ^ iWA^m 

'^^mmMm i- The next byte ^pi^^iSiE m mmmmtion of 2 as m 1, 
The last byte (>1E) specifies a duration of 30/60ths of a second. You can terminate 
sound with data >01, >9F, G. 
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20^ DIRECT ACCESS TO THE SOUh«> OEHERATQR 

Any sound list, excluding the time duration data, can be directly loaded into the 
sound processor at address >8400. This address is in the DEF table in the utility 
program, so REF SOUND must be included in your program. If you use this direct 
loading, you must include an appropriate time delay so Cftgt fcs Wff^a for the 

desired period. This method does riot involve the interrupt processing routine in the 
console. 
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20-> SOUND GENCRATOR FREQUENClTES 

The following table lists the data used to produce various notes with generatOT !• 
The first nybble must be changed to use generator 2 or 3. 

Alternatively, you can find the note half a step above a given note by the following 
formula- 



New frequency = old frequency * 2^^^^^^ 



,a/i2) 



For ejtamp^ ^lim i$^^mm$ half a than middle A is 440 * 2^^^-*-^^ or 

In the table, the first number after the note specifies the octave of the note. The 
second number, which is always 1, specifies that this is for generator 1. This table, 
and ^wiim '§m$ f^f •^mmmm 2 %Wi 3* Wt& ©ten in producing mtMeu r«jr 

eicample, your program might contain 

AOl EQU >Q?3F A on generator 1. 

AD2 EQU >A93F A on generator 2. 

A03 EQU W^W A on generator 3. 

A#01 EQU >0O3C A# on generator 1. 

and so on. You may then refer to notes by name rather than by the data required to 
produce them. 







Desired. 


Frequency 


Note 


Data 


Frequency 


Code 


AOl 


893F 


110,00 


1017 03F9) 


A#oa 


803C 


116.54 


960 O3C0) 


BOl 


8A38 


mt7 


m ^mm 


Cll 


873S 


130.81 


855 0357) 


C#ll 


8732 


138.59 


807 0327) 


Dll 


8A2F 


146.83 


762 02FA) 


D#ll 


8F2C 


155.56 


719 02CF) 


tu 




164.81 




Fll 


mm 


xmm 


mi ^mu 


F//11 


8D25 


185.00 


605 025D) 


Gil 


8B23 


196.00 


571 023B) 


G//11 


8B21 


207.65 


539 021B) 
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Desired Frequency 



Note 


Data 


Frequency 


Code 


^11 






una 




A#ll 


80IE 


233.08 


4oU 


UiEu; 


BlI 


a5ic 


246.94 


/i 'i"? 


l>H-5; 


C21 


8C1A 


261,63 




/■si AO^ 


C#21 


8419 


277.18 


ht\h 




DZl 


8D17 


293,66 


^1 


^3*x7Di 


D#21 


8816 


311.13 


>6u 


(,>16a) 


E21 


8315 


329.63 


339 


0153) 


F21 


8014 


349.23 


Too 

320 


(>140) 


F#2i 


8E12 


369.99 


Too 

302 


012E) 


an 


8D11 




285 


OllD) 








269 


C>10D; 


A21 


8E0F 


440.00 


254 


(>DFE) 


A//21 


800F 


466.16 


240 


[>Ur U) 


321 


82GE 


493.88 


226 


/'s.nc^o^ 




860D 


523.25 


91 /i 
/X4 










/UZ 


V.>UU-MJ 


D31 


BEOB 


587.33 




(.XJHL) 


D#3-l 


84QB 


622.25 


inn 


/von /. \ 

(>0B4} 


E3I 


8AQA 


659.26 


170 


OOAAJ 




Si» 








Fiii 








/3fc.-rtiftT V 

0097; 


G31 


SFOS 


783.99 


143 


<>08F) 


G#31 


8708 


830.61 


135 


O087) 


A31 


aFQ7 


880.00 


IZ / 


U07I-J 




8807 


932.33 






B>1 






1x5 




Cal 


8B06 


1046.50 


1 m 
iU/ 




C#41 


8506 


1108.73 


1 m 


[,>U65; 


D41 


8F05 


1174.66 


y5 


t>U5r J 


D#41 


8A05 


3;*244.51 


on 


4,>05A; 


£41 


8505 


1318.51 


□G 

o> 




F41 


8005 


1396.91 


80 


O050) 


F#41 


8C04 


1479.98 


76 


O04C) 


G41 


8704 


1567.98 


71 


O047) 


G#41 


8304 


1661.22 


67 


O043) 


A4I 


8004 


1760.00 


64 


(>040) 




mzm 




& 


fr03C) 


m\ 


8903 


1975.53 


57 


CM139) 
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Note tMtm T^mu&my 


C51 


8503 


2093.00 


C#31 


8203 


2217.46 


D51 


8003 


2349.32 


D//51 


8D0Z 


2489.02 


E51 




2637.02 


F51 


8802 


2793.85 




8602 


2959.96 


G51 


8402 


3135.96 


G#51 


8202 


3322.44 


A51 


8002 


3520.00 


A#51 


8EQ1 


3729.31 


B51 


8C01 


3951.07 


C61 


SBOI 


4186.01 


C//6i 


8901 


4434.92 


D61 


8801 


4698.64 


D#61 


8601 


4978.03 


E61 


8501 


5274,04 


ra 


8401 


5587.65 




53 


(>035) 


50 


O032) 


48 


(>030) 


45 


(>02D) 


40 


(>02B) 


38 


(>026) 


36 


(>024) 


34 


O022) 


32 


(>020) 


30 


OOIE) 


28 


OOlC) 


27 


OOIB) 


25 


O019) 


24 


{yam 


22 


O016) 


21 


O015) 


20 


O014) 
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20*4 EXAMPLES 

The foilowing sections show a program segment which accesses the sound controller 
and two programs, one that plays a chime, and one that makes a crashing sound. 



20.4.1 Acscessing the Sound ControUer 

This program segment shows how to access the sound controller, assuming that the 
sound table is in VDP RAM, 



HOI 
* 

START 



EVEN 

LIMI 
LI 

MOV 
MOVB 
SOCB 
LIMI 



>01 



0 



R10,TABLE 

RlQ,[§>a3CC 
@H01,(i>83CE 
©H01,§>83FD 
2 



Disable VDP interrupt. 

Lms mM n^h $0tG 

RAM. 

Load it at >83CC. 
Trigger sound processing. 
Set VDP RAM flag. 
Enable VDP interrupt. 



in VDP 



The following program repeatedly plays a chime. 



* Example program tl3 pl&f a ^me. 
» 

REF VMBW 
DEF CHIME 

» 

BUFFE R rou 

» 

* 

HOI BYTE >01 

EVEN 



VDP HMM l^ffe used by the sound 
generator. 
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« 

CHIME 



LI 
LI 
LI 

BLWP 



RO,BUFFER 
R1,CDATA 
R2,118 

eVMBW 



Load VDP RAM buffer address. 

Pointer to the sound data. 

118 bytes to move to the VDP RAM 

buffer. 

Move to the VDP RAM. 



LOOP 



LIMI Q 

LI RlOjBLfTER 

MOV Rio,®>m^ 

SOCB §H01,@>83FD 

MOVB (aH01,@>83CE 

LIMI 2 



Disable VDP interrupt. 
Load sound table s#feess. 
Load pointer to the table. 
Set VDP flag. 

Trigger sound processing. 
Enable VDP interrupt. 



* 

LqOP2 



» 

CD ATA 



MOVB 

JEQ 

JMP 

BYTE 

BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BfTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 

mrvE 

BYTE 



[i>a3CE,®>83CE 

LOOP 

LOOP2 



Check if Lime is up. 
Repeat the sound. 
Wait until finished. 



>05,>9F,>BF,>DF,>FF,>E3,1 

>09,>8E,>01,>A4,>02,>C5,>01,>90,>B6,>D,3,6 

>03,>91,>B7,>D4,5 

>03,>92,>B8,>D5,4 

>03,>94,>B1,>D7,6 

>03,>95,>B2,>D8,7 

>05,>CA,>02,>96,>B3,>D0,6 

>03,>97,>B4,>D1,5 



>03,>91,>B7,>D4,6 
>03,>92,>B8,>D5,7 
>05,>A4,>02,>93,>BO,>D6,6 
>03,>94,>B1,>D7,3 



>05,>C5,>ai,>96,>B3,>D0,5 
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B¥TE 
BYTE 
BYTE 
END 



>03,>98,>B5,>D2,7 
>03,>9F,>BF,>DF,0 



20^4.3 A Crash 



The foUowing program makes a crashing sound. 



* Example Program to make a cra«di sound. 

RET VMBW 



DEF 



BUFFER 



* 

HOI 

CRASH 



* 

LOOP 



LQ0P2 



BYTE 
EVEN 



LI 
Li 
LI 



LIMI 
LI 

MOV 

SOCB 

MOVB 

LIMI 



CRASH 
>10O0 

>01 



RO,BUFFER 
RljCDATA 
R2,32 



BLWP iVMBW 



Q 



R10,@>83CC 

@H01,(a>83FD 
®H01,©>83CE 
2 



MOVB g>83CE,®.>83CE 
JEQ LOOP 
JMP LOOP2 



VDP RAM buffer used by sound 
generator. 



Load VDP RAM buffer address. 

Pointer to the sound data. 

32 bytes to move to the VDP RAM 

bufff^* 

Move to VDP RAM buffer. 



Disable VDP interrupt. 

Loa(^ msni tiito gtj^e^ 
Load polntei^ im %M table* 
Set VDP RAM ^ag^ 
Start sound processing. 
Enable VDP interrupt. 



Check if time is up. 
Finished with the sound table. 
Wait until finished. 
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SQUNP 



CDATA 



BYTE 


>03 >9F.>E'i >F2.5 


BYTE 


>02.>E4.>F0.12 


RYTF 

LJ T IE. 


^n? ^F"A ~>F7 1 n 


BYTE 


>02,>E4,>F4,8 


BYTE 


>Q2,>E4,>r6,6 


BVTE 


>02,>E4,>F8,4 


BYTE 


>02,>E4,>FA,2 


BYTE 


>01,>FF,0 


END 
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The TI Home Computer gives you the capability of displaying a wide variety of 



multicolor, and bit-map (available only on the TI-^9/4A). 

In graphics mode, you can use the standard ASCII characters and define new 
characters. You can make characters and their backgrounds a variety of colors. 



except wheh editing, TI BASIC, and most applications. 

In multicolor mode, you can set the colors of a number of small boxes. The screen 
is 64 columns by 48 lines. 

In text it)0)i@it use the standard ASCII characters and define new characters. 

All iMmmwrn^ 0m. mm mm^ M m^tmi^M is one color. The screen 40 
columiis by 24 lines. This is the mode used by the Editor. 

In bit-map mode (available only on the T1-99/4A because of its use of the TMS9918A 
video pf&mmm ^tmmd Iftt Tlii^^tl pfl?;6£!e^ii^j fim &m s# m^' <the 



smallest dot on the screen) ori 151? 0ff Mid mik^ W:m pixels and the background a 
Variety of colors. The screen is 256 columns by 192 lines^ 

In all modes except text, up to 32 sprites (moving graphics) can be created and set in 
motion \tfi'^Qi^ ftsrttier program control. 




The screen is 32 columns by 24 lines. 
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2X.X VW WRITE-ONLY REGISTERS 

Before using the different modes, certain preliminary infc^msiion is neeessary. The 
following describes the eight VDP write-only registers. 

f^i^ter 0 tfrt^^ fm k^^m Q M « to tim E^tor/i^ii^^p^ Tl 

BASIC, and TI Extended BASIC. 

Bits 0-3 Reserved. Must be OQOOOD. 

Bit 6 Mode bit 3, called M3. If this bit is set, the display 

Is in bit-map mode. 

Bit 7 External video enable/disable. A value of 1 enables 

video input and a value of 0 disables video input. 

VDP Register 1 The default for Register 1 is >E0 in the Editor/ Assembler^ TI 
BASIC, and TI Extended EtiS^IC* Hmm Before ch9«girs§ 
Register, put a copy of the new value you wish it to have at 
address >83D4. When a key is pressed, a copy of the value at this 
address is placed in Register 1. 

Bit 0 teiee.tiffl$» ^ value of $ selects 4K RAM 

operation, and a Value of 1 selects I6K RAM 
operation. 

Ml I Blank enable/disable. A Vflkie of 0 causes the active 

^p^y (t£m ^itim sm^n) to be blank, and a n^aloe of 
1 allows display on the screen. With a value of 0* 
the screen only shows the border polar, 

interrupt, and a value of I enables VDP interrupt. 

Bit 3 Mode bit 1, called Ml, If this bit is set, the display 

is in text mode. 

Bit 4 Mod^ bit 2, called M2. If this bit is set, th© dt^^ 

is in multicolor mode. 

Bit 5 Reserved. Must be 0. 
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Bit 6 




Bit 7 



Sprite magnification selection. A value of 0 selects 
unmagnified spHte% «l*^ a value of 1 selects 
magnified sprites. 



VDP Register 2 



VGif* Register 1 



VDP Register 4 



VDP Register 5 



The default for Register 2 is >D0 in the Editor/Assembler, TI 
BASIC, and TI Extended BASIC. 

Dfefrj«^ tftfe mm ^Mtim W ttm MWm tmw^ Table. The Screen 
Image Table base address is equal tb the value of this register 
times >40D. 

t^he default for Register 3 is >QE in the Editor/ Assembler, >0C tfi 
TI BASIC, and >20 in TI Extended BASIC. 

Defines the base address of the Color Table. The Color Table 
base address is equal to the value of this register times >40. 

The default for Register 4 H >Q1 In tJie Editor/ Assembler and >00 
in TI BASIC and TI Extended BASIC. 

Defines the base address of the Pattern Descriptor Table. The 
Pattern Descriptor Table base address is equal to the value of this 
i^^er times >8Q0. 



The default for Register 5 is >06 in the Editot/Assembler, Tl 
BASIC, and TI Extended BASIC. 

Defines the base address of the Sprite Attcifeu^ List. Th6 
Attribute List base address is equal to the value af this register 
times >80. 
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VDP i^©f^sp g The default for Register 6 U >W in the Editor/ Assembler, TI 
BASIC, and TI Extended BASIC. 

Defines the base address of the Sprite Descriptor Table. The 
Sprite Descriptor Table base address is equal to the value of this 
register MWS >SCHJ. 

VDP Register 7 The default for Register 7 is >F5 in the Editor/Assembler and >17 
in TI BASIC and TI Extended BASIC. 



Bits 0-3 The color code of the foreground color in text mode. 

Bits 4-7 The color code for the background colcw in all modes. 

The mode bits, Ml, M2, and M3, are in bits 3 and 4 of Register 1 and bit 6 of 
Register 0. They determine the mode of the display. If they are all reset, the 
tfispiaf k 'm ^.^0^ mode. If Ml, in bit I af Bm^Mm 1, is set, the display is in 
text modfe If Mt,. iifi 4 of l^j^^be^ 1^ Is aet^ :^iie ^splay is in muIti^M^o^ nE^isda. 
If M3, in bit 6 of Register 0, is set, the display is in bit-map mode, available only on 
the TI-99/4A. 
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GRAPHICS MODE 

In graphics rnode, you can use the standard ASCII characters and define patterns or 
characters and their foreground and background colors. The display is 32 columns by 
24 lines. You can use sprites. Color and graphics are avaiiabJe by defining each of 
the 256 characters and setting their foreground and background cfolto. The M^ie^M 
ASCII charactiCTs are predefined by the system 8oft^wa^ei 

21.2.1 Pattern Descriptor Table 

The Pattern Descriptor Table contains descriptions of the 256 patterns or characters. 
By j^iangdrsg itese sdewstSptene, you can np^^mmm 'Urn ^racter on the 

screen. The description of each of the 256 patterns or characters takes eight bytes 
of information. The description of the subprogram CHAR in the User's Reference 
Guide discusses character definition. 

In the E^aMarj^dsimM^y PMe£jgrn Description Table starts at a<ite^ >D80a. 
Thus, the description of character >0Q occupies addresses >0800 through >0807, 
character >01 occupies addresses >0808 through >080F, and character >FF occupies 
addresses >0FF8 through >OFTF. 

21^2.2 Color Table 

The Color Table contains the descriptions of the foreground and background colors of 
the characters. The most-significant four bits of the byte specify the foreground 
CGlW the least-significant four bits specify the background color. Each byte 
specifies Wm mlov for a group of eight c!tam:ters. The 16 eolisim midyi#|ls on the TI 
Home Computer and their hexadecimal codes are listed on the next page. 
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1 — lovfiHpr'imnT 




1 — IcsvaHfsoi mA) 


VnlciP 








1 1 di Lopal el 1 L 


n 
u 




a 

Q 


DidUK 


1 

_L 


1 1 n h ^ t* o H 
t_ ILJI 1 L 1 OU 


q 


ivieuiuiii Ljiccii 




u/di K yeiiuw 


A 


Light green 


3 


Light yellow 


M 


Dark blue 


4 


Dark green 


C 


Light blue 


5 


Magenta 


D 


Dark red 


6 


Gray 


E 


Cyan 


7 


White 


F 



In the E£ti%^/AmMI^> the Color Table stso-ts at; s^^^bmss 'KI33@. ThifS, t^e 
address >0380 specifies the colors of characters >00 through >07, the byte at address 
>0381 specifies the colors of characters >0B through >0F, and the byte at address 
>039F specifies the colors of characters >F8 through >FF. 

For ms^i^^ief placir^ %. ^^ue of >17 at address >0184 sets the colors of characters 
>20 through >27 to black on cyan. 



21.2.3 Screen Image Table 

The Screen Image TiSible specifies the chara^ttrt fititl ®tmM|^ of the scre^ 

positions. Each byte specifies the character at one screen position. The 768 screeh 
positions are arranged on the screen in 24 rows of 32 columns. 

In the Editor/Assembler, the Screen Image Table starts at address >Q0DO. The first 
32 addresses C>0000 through >001F) contain the characters for the first row, the 
second 32 addresses (>0020 through >003F) contain the characters for the second row, 

and so on. 

For example, if the yakxm Ml twiia% t^ tcr tim P^VtJ eharacter ^ ok 
adefeess W^t^ kfm ^sc^ster desc^^d si s^^te^^ >QA08 through >OAQF of the 
Pattern Descriptor Table appears in the third column of the second row, assuming the 
Pattern Descriptor Table starts at address >08DQ, 
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£1.3 MULTICOLOR MODE 

In multicolor mode, the display is div^tetd into 48 rows, each containing 64 "boxes" 
that are four pixels by four pixels. Each of the 3072 boxes thus defined can be one 
of the 16 colors available. You can use sprites in multicolor mode. 

Ydu should initiaUze the Screen Image Table so that the first >8D bytes contain >0Q 
through >1F repeated four times, the next >80 bytes contain >2D though >3F repeated 
four times, and so on^ so that the last >80 bytes contain >A0 through >BF repeated 
four times. 

The Pattern Descriptor Table, instead of containing patterns^ contains colors. Each 
pattern in the Pattern Descriptor Table contains eight bytes. In multicolor moCley 
each group of eight bytes contains 16 color descriptions, each giving the color of ohe 
box. The colors are as given in Section 21.2,2. The left four bits of each byte 
describe the color of one box and the right four bits describe the color of the next 
box on the same row. 

The first byte in the Pattern Descriptor Table defines the colors of the first two 
boxes in the first row. The second byte defines the colors of the first two boxes in 
the second row. The third byte defines the colors of the first two boxes in the third 
Hte This «cmt1liy^& imit %^ titiljtm &f the f ira^ Iwo boxes In each of l^e fli^t ^t^hl 
rows have been defined. 

The next eight-byte segment similarly defines the colors of the third and fourth boxes 
in each of the first eight rows. This definition continues until the first 32 eight-byte 
segments have described all the boxes in the first eight rows. Subsequent groups of 
eight rows are described in a similar manner by subsequent of 32 0i|^*%te 

segiTiBnts. 

The following diagram represents the screen and how it is divided in multicolor mode. 
Tfm ^reen Innaip Tatole address is the offset from the beginning. The Screen Image 
Table value is what you should insert in the menrs^ tesEW* 
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Screen 
1 ab 1 e 


Image 
Addr e s s 


Kow X 


L-o 1 urm s 

I. J 4 ... 64 


Screen Image 
Table Value 


V. n ^ 




T 1 

X J 


til 111 


>0t) - 


>1F 


>0000 


- >001F 


2 1 


III til 
1 1 I ... 1 1 1 






>0020 


- >003h 


3 1 


1 t 1 III 
1 i 1 . . . j 1 1 


>00 - 


>1F 


>0020 


- >0U3F 


4 1 


111 1)1 
t 1 ] . . . 1 1 ] 






>oa^ 


- >Q05F 


^ I ] 


J 1 1 ... I 1 1 


>00 - 


>1F 


>t)040 


- >005F 


6 T 


I f 1 1 r 






>0060 


- >D07F 


7 1 


[ ) I ... 1 1 1 


>0d - 


>1F 


>D060 


- >Q07F 


8 1 


1 i 1 ... 1 1 1 






>UUoU 


- >uuyr 


Q ( 


III III 
i 1 1 ... 1 1 1 


>20 - 


>3F 


u u o u 

• 




1 n 1 


III ill 
1 1 1 * * • 1 i 1 

■ 


• 




* 

>02EQ 


- >02FF 


■ 

47 1 


■ 

1 1 1 ... 1 1 1 


* 

>A0 - 


>BF 


>02E0 


- >D2FF 


48 1 


1 1 1 ... 1 1 







The following table shows the ^^^^^^ T^felfe character code, the addresses in 

the pattern Descriptor Table, assuming that it starts at address >D80D, and the 
portions of the screen that those characters and addresses describe. 



Screen Image Table Pattern Descriptor Row and Columns Described 

Character Code Table Address Row Coiumns 

>00 >080Q 1 1 and 2 

>00 >tWL 2 1 and 2 

>00 >0802 3 1 and 2 

>00 >0803 4 1 and 2 

>Q0 >0804 5 1 and 2 

>00 >0805 6 1 and 2 

>00 >O8]06 7 1 and 2 

>00 a 1 and 2 

>0i >0808 1 3 and 4 

>m >080A 2 3 and 4 



>BF >QDfr 48 63 and 64 
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21,4 TEXT MODE 

Im tenet ifi^ie, the di^l&y k 40 columns by 24 lines. Ym j^rvK tm 
tables used to generate the patterns are the same as the Screen Image Table and 
Pattern Descriptor Table used in graphics mode. However, since 960 screen positions 
are used instead of 768, the Screen Image Table is longer. The definitions ignore the 
last two bits in each entry so that each character has a 6-by-8 pixel definition. The 
Editor is in text mode. 

The two colors available in text mode are defined in VDP write-only Register 7. The 
leftmost four bits describe the color of the pixels that are on and the rightmost four 
bits describe the color of the pixels that are off. 

For example, if the Screen Image Table stGa^BI &% wM^HS^ >6PM and >41 is at address 
>0202, the ASCII symbol A is placed on the 35th column of the 13th row. In 
graphics mode, however, this address and value would place the A on the third column 
of the 17 th row. 
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positions of the screen. Additionally, more color information is available for each 
B-by-8 pixel pattern. You can use sprites, but not their automatic motion feature. 

tti bit-map mode, the patt^w occupy screen pa^lUlt m d^sc^lt^lid In dtt 
i^^f^ im^. T0tM^ the pattern ^si^^^titss me in the ^^ean Descriptor Tabl^j and 
the colors of the ch^'acters are de^ribed in the Color Table. 

^Skl Sclera Image T^ile 

The Screen Image Table lists the names of the patterns, from the Pattern Descriptor 
Table, that are to be generated. Each name is a single byte from >00 to >FF. 

The table is divided into three sections, with each section describing 256 entries. 
The first section of 2^6 entries uses descriptions taJ<en from the first 256 entries in 
the f^mtrn Table ami tfee ^^im Ttm seoond «:tion of Z$M. mMm. 

uses descriptions taken from the second 256 entries in the Pattern Generator Table 
and the Color Table, and the third section of 256 entries uses descriptions taken from 
the third 256 entries in the Pattern Generator Table and the Color Table, 

The first 32 enMrs p^^ems that are placed on the first ^ the 

screen, the second 32 entries describe the patterns on the second row of the screen, 
and so on. The Screen Image Table should usually be placed starting at address 
>1800 by setting VDP write-only Register 2 to >06. 

21.5.2 Pattern Descriptor Trijle 

The Pattern Descriptor Table is divided into three sections of 256 entries each and 
thus contains the 768 possible patterns. Each description is eight bytes long. The 
description of the s^ipf^ram CHAR in the l^^t FM^eg'^n^ QmI^ discusses 



ei^racter ctefinition. 
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The descriptions in tfm fMt ^ Eh# table, 256 entries or Mii bytes, deiS^rfm the 
ehsracters in the first third of the screen. The descriptidns irt the i^etansa MM mf 
the table describe the characters in the second third of the screen and the 
descriptions in the last third of the table describe the characters in the last third of 

the screen. 

The Pattern Descriptor Table is >1800 byt^s long. You must start it either at 
mmmm mma m >Wm W ^la^Sg Mm. >m or >04 in VDP write-only Regitt^ % If 
the Pattern Descriptor Table starts at address >000D, the Color Table must Start at 
sddress >200C, and vice versa, 

^^I-5„3 Color Table 

The Color Table contains the descriptions of the colors of the characters in the 
Pattern Descriptor Table. The color codes are as described in Section 21.2.2. Eight 
bytes m&d to; ^s^ib^ the colors of each character. The first nybble of each 
^m- ^m^^m ^ ©ttliSe W ^elt ma on in one raw ijf pIlE^ the 

second nybble describes the color of the pixels that are off in the aanrie row bf eight 
pi)iels. 

Tti® color descriptions in the first third of the table, 256 entries or 2048 bytes, 
describe the colors of the characters in the first third of the screen. The 

dewijations in the seconf J^ird of the table describe the colors of the characters ifi 
the ^GOnd third of the screen and the descriptions in the last third of the table 
describe the colors of the characters in the last third of the screen. 

The Color Table k >i#OEj hfim ¥©u must start Jte Bi#i^ ^ address >Q000 or 

%mm^ p^m^g either >tiUm ^ in'WW^- '^^^S'-m^f Register 5, If the Color Table 
starts St address >OQDQ, the Pattern Descriptor Table must start at address >2000i 
and vice versa, 

Bit-Map Mode Discussion 

In using the bit-map mode, it is usually easiest to initialize the Screen Image Table 
to >0n through >FF repeated three times, and then alter the entries in the Pattern 
Descrlj3^ Tate ar^ the d^l^ TlKbJ#. 
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To alter a pixel on the screen, you must calculate the byte and bit to be changed in 
the Pattern Descriptor Table. T^f Stoi^ £tm »@pmriad Sftfl bit^l^^tiii et)l^ a 
TOW of eight pixels, you must calculate the byte that must be changed in the Color 
Table. The following program segment allows you to find those values. 

The program segment assumes that the X-value of the pixel is in Workspace Register 
D (RO) and the Y-value of the pixel Is in Workspace Register 1 (Rl% The offset of 
Xim byte that you must change in the Pattern Generator Table is returned in 

Workspace Register 4 CR4), and the bit that must be altered is returned in Workspace 
Register 5 (R5). The offset of the byte that you must change in the Color Table is 
also returned in Workspace Register 4. 



MOV 




SLA 


R4,5 


SOC 


R1,R4 


AND I 


R4,>FF07 


MOV 


RJJ^RS 


m0i 


R5,7 


A 


R0,R4 


s 


R5,R4 



Rl 18 the Y value. 

RO is the X value. 

R4 is the byte offset, 
R^ is the bit offset. 



21.5.3 Bit-Map Mocfe Ei^mnj^le 

Suppose the entry for a character in the Pattern Descriptor Table is 
>Ff 9999FF18244ZC3. This defines the character shown below. 

Chara©t%* Pattern 



* 


* 


*!* 


* 1 * 


* 




FF 






1* 


*1 




*l 


99 


* 




I* 


*! 




*l 


99 


* 




* 1 * 


* [ * 


-X- 


* 1 


FF 






1* 


*l 




1 


18 






*l 


I* 




1 


24 






1 


1 


* 


1 


42 


* 




I 


1 




*1 


C3 
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If tentry in the Cblor Table is >4:6464646i^iD4D4D4D, the pattern is as f allowsi 

B representing dark blue (H), R representing dark red {>6)f and M representing 
magenta (>D). 



Cha r ac t e r 



|B[B[B|B1B|B|B|B| 
iBlRlRlBlBlRiRlBl 
|B|R|R|B|BlR[R[Bi 
IBIBIBIBIBIBIBIBI 
lMlMtM[B|B|M|M|M| 
iM|M|BlM|M[B[M|M| 
|M|B|M|M|M|M|B|M| 
iBlBlMjMlMlMlBlBl 



Pattern Colors 



FF 


46 


99 


46 


99 


46 


FF 


4£ 


18 


4D 


24 


4D 


42 


4D 


C3 


4D 



On a magenta background, the mafe^ta p(*etJ®HS of ^ character blends with the 
background. With the pixel markings removed, the character appears aS follows, withf; 
* representing dark blue (>4) and = representing dark red (>6). 



t » # » 

* = = * 

* = = * 
« # » « 

* 

* 

* * 



* t # »■ 

* = * 

* = « * 
« « W » 

-M- 

« * 



E;DiTOR/A$SEMBLEH 

Psige 337 



COLOR, GRAPHICS, AND SPRITES 



il*6 SPRITES 



Sprites are moving graphics that can occupy space on the screen independently and in 
addition to the characters which normally make up the screen. You can define aiid 
place in motion up to 32 spriites of any shape and several different sizes. After you 
start sjSPitee Wts^f^ tW? mtat^i^n ficyt^liii^t '^Wimfc teCNfer prograrf? fWi 
mVi t^m S^^^ 1^ p^^GS, multicolor, and bit-map mode. In bit-map- mode, 
however, automatic motion cannot be used. Sprites are defined by setting up tables 
that indicate their position, their pattern, their color, their size, and their motinn. 

21.6.1 Sprite Attribute List 

The Sprite Attribute List defines the position and color of each of the 32 possible 
sprites, numbered 0 through 31. As sprites move, the entries in the Sprite Attribute 
lA^ at© tfhanged, 

fm sprites, 1^ mveen is divided ir^ 11^ IX3t0 sf PiMt ndmmm, Each of 
these locations iji| ealled a pixel, the smallest dot that can be displayed on the screen. 
The top row of pixels is designated >FF, followed by >00, >D1, and so forth up to >SF!. 
The left column of pixels is designated >00, followed by >01, >02, and so forth up to 

Each sprite definition takes up four bytes in the Sprite Attribute List. The first byte 
is the vertical (Y) position of the sprite and starts at >FF, followed by >00 through 
>BE. The second byte is the horizontal (X) position of the sprite, which can be from 
>0Q through >FF« The third byte is the pattern code, which can be from >00 through 
>FF. The Utju^h by*© h feJ® early clock attribute, which controls the location of the 
sprite, and color of the sprite. 

Y-locations with values of >C0 through >FE are effectively off the bottom of the 
screen* hfcp^j^ m y-^k&mUm sf >D0 ©auses that sprite and ^1 following it in the 
Sprite Attribute List to be undefined. For example, if the Sprite Attrto:^ 
starts at address >0300 and no sprites are defkt^^ %fm >tM plJa^jEJ. at 

address >0300. If the fifth sprite is the last one active, a value of >D0 should be 
placed at address >0314. You can leave all 32 sprites active with the ones you do 
not wish to appear located off the bottom of the screen. However, it is 




: fm SiSfUSe the final unused sprites to be undefee^ litMh a 



Y-locatibn of >D0. 
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The third byte of each entry of the Sprite Attribute Table defines the character 

p9eti« ism fm the sprite. The pattern can be fjom >flQ to >FF and c^^pm^j^iia tst 
a xrfiaracter defined in the SfH-lte Descri|jfe^ T^a. Far tt W 

Editor/AssemblCT addresses >A00 through >407 contain the entry for character >10. 

The four most-significant bits in the fourth byte control the early clock of the sprite. 
If the last of these four bits is 0, the early clock is off. Then the sprite's location is 
its upper left^iand comer, and it fades in and out on the right edge of the screen. 
If the last of these four bits is 1, the early clock is on. Then the sprite's location is 
shifted 32 pixels to the lefti allowing it to fade in and out on the left edge of the 
screen, 

Tht mim ^ W Sfiecified in tm fmr least-significant blU of the fourth 

of the ^rite de^ription. The values used are the same as those given in Section 
21.2.2. 



In the Editor/Assembler, the Sprite Attribute List starts at address >0300. If you 
v/ish ^ immmt^J^' itmtm^ tfm tpritt Atotete List must start at itist g^iress. 
%f fmS' put $£ef^lt base s^pem (>6QO0) in VdF^ Re^Mer thm ^imm ^^^tpm^ 
Table (described in Section 21.6.2) starts at address >0000, Since the area >0000 
through >03FF is used for the Screen Image Table, Color Table, and Sprite Attribute 
List, character codes starting at >80, at address >0400, are then normally used for 
sprites. When you use sprite motion, only the character codes from >80 through >EF 
can be used because the Sprite Motion Table starts at address >0780. 



21. 6.2 Sprite Descriptor Table 

The Sprite Descriptor Table de^rfbe^ %he sprite^ patterns in the same way as in the 
Pattern Descriptor Table. However, sprites can be double-size or magnified by 
writing a value to the two least-significant bits in VDP Register 1. The follovying 
description tells the different sizes and magnifications possible. 
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Value Description 

00. ^fitf^liri ^im '^m^ U S by S pixels, the sam# m i 

01 Magnified sprites. ^H^^ te IB ^ 16 pixels, equal ^ ^mst^tm^aitd 

characters on the screen. The pattern definition is the same as for 
standard size sprites, but each pixel occupies four pixels on the screen. 

10 dk^tJ^lS^ii^e sprites. Each sprite is 16 by 16 pixels, equal to four 
standard charactea m Ite mt&m% Eaeh ^ite is defined by four 
consecutive patterns from the Sprite Descriptor Tablgst- For example, 
each of the character codes >80, >8I, >82, or >B3 causes a double-size 
sprite to use characters >80, >81, >82, and >83 for the sprite. The first 
of these characters is the upper left-hand corner of the sprite, the second 
Is the lower left-hand corner, the third is the ?^pES0 il^lili^t^tM ^tt^Fj 
and ^ ftmVrt ^ ttSB imm rigM-tartI i^mm^* 

11 Double-si;|:0 .tfiagnified sprites. Each sprito is 32 by 32 pixels, equn! to ]6 
standard characters on the screen. Sprites are defined as described under 
double-size sprites, and each pixel occupies four pixels on the screen. 

In the E«il£j9iefi^S®9HifbiOTi ^e Sprite Descriptor T^^e starts at address >iIMM te 
pattern code >00. However, addresses >0'^00 and above are usually used for the block 
because the Inv^/er addresses are used for the Screen Image Tabic, Color Table, and 
Sprite Attribute List. The pattern defined starting at address >0400 is referred to as 



21.6.> Sprite Motion Table 

Ifm Sprites Mefiian Table defines the motion of sprites. It must start at address 
>0780. In order to move sprites, you must set up a number of conditions. 

First, interrupts must be enabled during the execution of the program. Therefore, 
every time the program accesses the VDP RAM, interrupt handling must be disabled, 

Mtb default. If you have enabled interrupt handling v/ith the LI MI 2 
instruction, you must disable it with a LIMI 0 instruction so that the intsrrtipfc 
handling routine does not alter the VDP write address. 

Second, an indication of the number of sprites which have motion must be put in CPU 
RAM address >837A. For example, if sprites 2 and 4 are moving, the number ? must 
be put at that address to allow for the motion of sprites D, 1, 2, 3, and 4, 
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Third, descriptions of the motion of the sprite must be put in the Sprite Motion Table 
Wti^i: '0^^^ starts at VI3P address >C)780, Each sprite's motion takes Up four bytes 




in the l^dSl^ii Tl^ i^f'ii ^ffesi^ ite vertical (Y) motion of the sprite. The 
second byte defines the horizontal (X) motion of the sprite. The third and fourth 
bytes are used by the interrupt routine. 

The velocity in the first and second byMS ^ »ige from >00 to XT. Velddities 
frm >M sfb pmiJ^m ^steltte tdmm it^e^iM Wtl^ MS 0ght for 

horizontal motion), and velocities from >FF to >80 are taken as two's-complement 
negative velocities (up for vertical motion and left for horizontal motion)* 

Pi v^^ie &f >^ cmjses the ^l£e tm rrrnvfe twre pixel i^M^ IB ¥0f* ifli^rupts, or 
once every 16/60ths of a second. 

Since sprites are set up by loading data into VDP RAM and the TI BASIC interpreter 
allows interrupts, you can run sprites by successive use of the statement CALL 
POKEV (see Section 17.1.6). However, caution must be taken not to interfere with 
the TI BASIC interpreter, which does not recd^^t^ the ejdstence of sprites* It is 
possible that the sprites may cause the TI BASIC interpreter to stop functioning- In 
TI Extended BASIC, this problem does not exist. 
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The Wst two t?f tfm foilowfrrg thr^ wmnhlf l^igi^^ pr^rams are similar in their 
effect, jm '^mm HW*^ te^k shapes on to Wmm^ and mmm them up the 

screen. It does not use sprites, so the motion is not snnooth. The second program 
defines the shapes as sprites, so the motion is quite smooth. In addition, pressing 
any key toggles the sprites from standard size to magnified sprites and back. The 
thtfrd pragrar^ III m 4mrm^&^m s^Tm$^ sprte Mtte. 

Each of these programs must be assembled with the R option, which automatically 
generates Workspace Registers, and run with the LOAD AND RUN option of the 
Edi tor/ Asse mbler. 



21.7.1 Graphics E^xample 

In the following program, several characters shaped like bubbles are placed on the 
screen and moved up the screen. These characters are not sprites, so the motion is 
not smooth* Run the pro^m with the LOAD AMD RUN option of the 
Edit^/^^WrH^te, i:^g the profEam mwe BUBBLE. To te^e the program, the 
computer must be turned off because no provision has been made for returning to the 
Editor/Assembler. 



DEF BUBBLE 

RET VMBW,VMBR,VSBW 




DATA 
DATA 
BYTE 



LOC 



BSS 



MYREG 
* 

* Set up colors. 
* 



BUBBLE 



LWPI 
LI 
LI 
U 



>3C7E,>CFDF,>FFFF,>7E3C 

>F333 
>AP 



DATA >0IDA,>O2QD,>0271,>02A5,>O2Dfi,>02El,>O0OQ 



>20 



MYREG 
R0,>594 

R2,2 
HViylBW 



Color Table 20 and 21. 
Le®^ mxUsm and 
Tvtfo bytes to loacJ. 
Move to VDP RAM, 
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4t 

* Set up dwacter ete^ntS^STfe 
* 

14 RO,>DOO 

LI R,1,BBLE 

LI R2,8 

BLWP §VMBW 

* 

* Clear screen 
* 

CLR RO 

LOOPl MOVB [iSPACE,Rl 

k: ro 

CI Ra,>300 

JNE LOOPl 

« 

* Place bubbles Ifee screen. 
* 

MOVB @BBL,R1 

LI R2,LOC 

LOOP2 MOV *R2+,R0 

MOV ROjRO 

JEQ SCROLL 

BLWP laVSBW 

JMP LOOP2 

# 

* Scroll Screen. 

VDPBFl ^ >20 

VDPBF2 ESS >20 
* 

SCROLL 

GLR RO 

LI RljVIDPBTl 

LI R2,>20 

BLWP @VMBR 

» 

LI R0j>20 

LI R1,VDPBF2 

LI R2,>20 



Character >A0 location. 
Definition of bubble character. 
8 bytes to move. 



Start at VDP RAM >0000. 
Move space character. 

-mm: -^mm. at a time. 
F^MjS 'im next location on screen. 
Out of screen. 



Load character code for bubble. 
Load pointer to address for bubble. 
Load real address. 
Check if finished loading, 
ipinished. Start scrolling the screen^* 
Write bubble on the screen. 



mmm address. 
CPU buffer address. 

Number of bytes to move. 
Move >20 from VDP RAM. 

W^p i^mm^ > 2 0* 

IKifW address. 
Numhw of bytes to move. 
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LOOP3 BLWP §VMBR 



M RQ,>40 
Gl R0,>300 
JL LOOP3 



U 
LI 

BLWP 




Copy the line. 

Write back is the lowen Une. 
Read next line. 
Check if end of screen. 
If not, copy more. 



Move CPU to VDP. 



first line is, 



JMP 

cm 



SCROLL 



Keep scrolling. 



21.7.2 Sprite Example 

In the foilowi^l 'pt-&^'$r$i several sprites shaped like bubbles are placed on the screen 
and rai^M ttiS Because sprites are used, the motion is quite smooth. 

Run the program with the LOAD AND RUN option of the Editor/Assembler, using the 
program name SBBLE. To leave the program, the computer must be turned off 
because no provision has been made for returning to the Editor/Assembler. 





DEF 




REF 




REF 


* 




BBLE 


DATA 


»L 


S¥TE 


SPACE 


BYTE 


SLIST 


DATA 




DATA 




DATA 


MYREG 


BSB 



SBBLE 

VMBW,VMBR,VSBW,VSBR 
VWTR,KSCAN 

>«f^,»C)F,>FFFF,>7E3C 

>80 

>20 

>70DO,>800F,>8068,>8QOF,>9888,>80QF 
>A828,>800F,>BOB0,>a0DF,>B8O8,>80OF 



>2a: 
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* Set up character 



SB&LE 



LWPI 
LI 
LI 
LI 

BLWP 



MYREG 
R0,>4D0 
R1,BBLE 

IVMBW 



Sprite character >8Q, 
Definition of character. 
S bytes to move* 



* Define sprites. 

LI 
Lf 
LI 

BLWP 



H0,>300 



R2,26 
iiVMBW 



f Sprite Attribute List. 
Rointer fe^ fc Ust. 
Move 26 bytes ta TOP RAM at >3GD. 
Move the list. 



* Scroll screen. 




MOVE 



>8375 
>837C 

>2000 



R5 

R0,>300 




Counter for sprite size. 

Pointer to the first Y-location. 
Read Qm byte into Rl> 

Check to see if it is finished. 
Check on key input. 
Decrement Y-location. 

Adjust the poihten 

Change it back to byte operation. 

Write back to the list. 

Points to the next location. 

Read next Y-pointei:,, 
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KEY 



* 



CHANGE 



LARGE 



SMALL 



CLR (3KEYBRD 

BLWP HKSCAN 

MOV §5TATUS,R5 

COC @SET,R3 

JEQ CHANGE 

J MP LOOP 



MOV R5,R5 

JNE SMALL 

INC R5 

LI R0,>Q1E1 

JMP LC3dP 

CLR R5 

IS RO,>01E0 

JMP LOOP 



Clear keyboard. 

Call key scan msiMi^ 

Check for status bit. 

Key pressed, change size of sprites. 

Otherwise, keep scrolling. 



Is R5 null? 

Make sprites small. 

Change R5. 
Change Rl to >E1. 

^OP register. 
Oo back to loop. 

Clear R5. 
Change Rl to >E0. 
Mstfily register. 
Go back to loop. 



END 



21.7.3 Automatic Sprite Motion Example 

This program is an example of using automatic motion* U places four magnified 
sprites in the middle of the screen and moves them in i^f^tent ^®i^i©FM at 
different speeds. Note that the LIMI 2 instruc£lEm k fc© in^&imi3^ to- 

occur. Without interrupts, sprites cannot be moved. Then, the LIMI 0 instruction is 
given to prevent the rest of the program from inadvertantly changing VDP RAM 
registers v^hich are being used by the ^rites' motion. 

Run the lar^am with the LOAD AND Rt^ ©ption of the Editor/Assemble, using the 
prog^SSSI tSlmife MOVE. To ^iSi^^ the program, the computer must be turned off 
beCjLuae no provision has been made for returning to the Editor/ Assembler. 
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KEF VMBW,VWtR,VMBR,VSiW 

* 

NUM EQU >837A 

SAL EQU >300 

COLTAB EQU >384 

PATTN EQU >400 

SPEED EQU >78D 

COLOR DATA >FFOO 

BALL DATA >3C7E,>FFFF,>FFFF,>7E3C 

SDATA DATA >6178,>8006 

DATA >6178,>8003 

DATA >6178,>800a 

DATA >6178,>800B,>DOOO 

SPDATA DATA >0404,>0000,>F808,>0000 

DATA >0CF4,>00DQ,>FaRJ,>mJ00 

MYREG ess >20 
* 

MOVE 

LWPI MYREG Load my own registers. 

LI R0,COLTAB 

mm i!tbLDR,Ri 

BLWP gVSBW Load background color as white* 

* 

LI RO.PATTN 

LI RljBALL 

LI RZ,8 

BLWP eVMBW Load ball pattern. 

*■ 

LI RO,SAL 

LI Rl,S£mTA 

LI n%u 

BLWP iVMBW Load Sprite Attribute List. 

* 

LI RO,SPEED 

LI R1,SPDATA 

LI R2,16 

BLWP @VMBW Load speed of sprites. 
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* 



LI 

BLWP 



R0,>81E1 
SIVWTR 



Load VDP 



LI 

SLA 
MOVB 



Rl,4 
RI,8 

Rl,igNUM 



Specify number of sprites. 



LOOP 



* 

LOOP2 



U 
LI 
LI 



Li Ml 
LI M I 

LI 

mMp 

AI 
CI 

JH 

NEXT AI 

DEC 
3EQ 
JMP 

ADJUST LI 
LI 

BLWP 

JMP 

END 



RO,SAL 

R3,4 

R2,2 



Repeat 4 times. 



Enable intena^* 
Disable interrupt. 



R1,MYREG+14 Read it into Register 7. 



Check if 0 < Y < 184, 24 < X < 224, 



Look at next sprite. 



R7,>B8C8 
ADJUST 
R0,4 
R3 

LOOP 

LOOP 7 

R1,SDATA 

R2,2 

©VMBW 

NEXT 



Reload Sprite Attribute List. 
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SECTION 22: SPEECH 



With tiio TI So^lid State Speech Synthesizer and the TI Memory Expansion unit 
attach:i;d to the computer, your assembly language programs can include speech. (See 
the owners manuals for these products for connection instructions.) 

To kmt& the computer speak s m "fefiSft ^ lE^^ii^ i^gi^ Synthesizer 

vocabulary, your program must check that the Speech Synthesizer is present, obtain 
the address of the word or phrase to be spoken, load the address in the synthesizer so 
that it can be spoken, and give the command to speak. You can obtain the address 
by looking it up in S«^^ 24.6, or you ^10 iitS It with your program* 

tasm e^ms provide speech data directly to the Speech Synthesizer instead of using 
a word from the resident vocabulary. Then you use a different command to have the 
word or phrase spoken. 



22.1 PRELIMINARY IhFORMATION 



Before uainq t.lie Speech Synthesizer, ynu must be familiar with the? timing 
requirements, addresses, and commands to use, and know how to load speech 

Wid check to see that the Speech Synthesizer is attached. 



22.I0I Timing Considerations 

The %0fchesizer requires time for each of eojtitiTSoat^rfb t^j ^3ce«mtedv TN^ 

■^^^ys iianis rmmm^y from the time a read data er tf^ad e^rrwnand is given until 

the data or status is available is 12 microseconds. The delay time from writing 
external data until the next access is 10 microseconds. The delay time from loading 
an address until the next command is 42 microseconds. 

During the delay after a read, the |»^he^ai inm which is connected to the 
Memory Expansion unit cannot be used. Therefore, the reads of data from the 
Speech Synthesizer and the delays must be in the area accessed by the 16-bit bug. 
One area convenient for this starts at address >8328, 

The follpwihg program segnrtent shows how to place the necessary delay In the ^o^r 
piafse* 
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SPCHRD 



SPDATA 
RE ADIT 

COPE 



EQU 
EQU 

MOVB 
NOP 
NOP 
NOP 
RT 
EQU 



>8330 



)5PCHRD,1SPDATA 



$-CODE 



CLEN 
START 

* Put read routine on 16-bit bus, 
LI 
LI 

LI 

MOV 
DECT 
JH 



STZ 



R1,READIT 

R2,CODE 

R3,CLEN 

*R2-t-,*Rl+ 

R3 

STZ 



Then to read a byte of speech data, use the instruction BL ©READIT. The data is 
returned at the address SPDATA. 




ffil^Bt^seconds can be accomplished by bransKII^ to routines, using 
, &ni relUEfdneg* The followif^ e©de segment shows the routines to 



delay for 12 and 42 microseconds. 
(§DLY42 instructions respectively. 



They can be called with BL @DLY12 and BL 



DLY12 



NOP 
NOP 
RT 



DLY42 LI 
DLY42A DEO 
JNE 
RT 



Rl,10 
DLY42A 
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In the rest of this section, the neeesssff5f delays are indicated by a Eomment as 
fQUE)>M3> Si^etian 2Z.2#2 giv&s a fcdmpl^te program u^ing these methods of delay. 

* Delay as described in Section 22.1.1. 



22.1.2 Addresses 

The two addresses used to read and write speech data are SPCHRD at address >9000 

SKHWr at You mal<e them available by psWc^ them in a REF 

stgitement at the beginning of your program. 

22^1*3 Commands 

Vtiu can the S^^ch Synthesizer ESBmtma'rr^s by placing a value in the OT>4^T 
address^ If you load >10, you can read a byte from the SPCHRD address. If you 
load >4X, vvhere X is a nybble to be loaded, the nybble is loaded. This is used to 
ioad spBbch addresses as described in Section 22.1.4. If you load >5D, the word or 
phrs^ wlrose m^p&m fmi hmm toided Is spoken. If you load >6Q, you een tad te 
v¥ord or phrase data* whicfi jm h&m ernisiafueted, to be spoken. Other commands are 
described in the TMS520D Voice Synthesis Processor Data Manual, available from 
Texas Iiistrur/ients. 

^2.1^4 Loading §p&Bch Addresses 

load Ihe address of the resident speech data by loading five nybbles of data, 
"ihe tifst nybbie is always >0, with the next four nybbles equal to the address. You 
tad ®aeh nybble with the >4X command, where the X is replaced by the nybble you 
Wish to load. The least: ^fpfificant nybbie is loaded 'timk. Xfm flf^ n|tefelB to be 
loa^^ ^mi^S >0 m mn fifth byts JmM h MO, mmk^ thn end af thm 
aGdres3„ The following program segment demonstrates how to load the address given 
in location PHROM. 
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PHROM 
LOAD 



REF 
DAW 


5PCHWT 




MOV 


@PHROM,R0 


Address to load. 


LI 


R2,4 


Four nybbles to load. 


SRC 


R0,4 


Start with least significant 


MOV 


R0,R1 




SRC 


Rl,4 




ANDI 


RI,>0FO0 


Get only particular nybble. 


ORI 


Rl,>4000 


pmst in >iSpOT fortnat. 


MOV8 


RI,@SPCHWr 


Write the nybble. 


DEC 


R2 




JNE 


LOADLP 




LI 


Rl,>4000 




MOVB 


R1,@5PCHWT 


Write the fifth nybble- 



in the rest of this section, the above process is indipated by a comment as follows. 



* Load address as described in Section 22.1.4, 
* 
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22.1.5 Reading Data 



Ckta mm ^^m^ from the Speecfe %rrthesizer by loading the correct address using 
the 4X command, writing a read command (>10) at SPCHWT, and reading data from 
SPCHRD. The following program segment shows how to read one word of data and 
store it at DATAAD. 

REF SPCHWT ,SPCHRD 



PHROM DATA <Speech Synthesizer ROM address> 

DATAAD DATA >0000 Data storage may be initialized to 

* zerOi 
SPDATA EQU >8328 

READIT EQU >8330 
HIO BYTE >10 

EVEN 

* 

READ 

* Load address as described in Section 22.1.4. 
* 



MOVB @H10,iaSPCHWT 



Read command. 



* Delay as describBd in Section 22.1.1. 
BL ©READIT 

* 



MOVB @H10,1SPCHWT 



Read one byte from the Speech 
Synthesizer. 

Read command again. 



* Delay as described in Section 22.1.1. 
* 

BL §REACHT 

M O VB 1 SPD ATA,®D ATAA D 



Store it in the next byte. 
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22.1.6 Checking to See if the Speech Synthesizer is Attached 




If 



Before your program attempts to produce speBeS%, M 
Speech Synthesizer U TNs ^®bs^ S^j^te 

this location contains >AA, the Speech Synthesizer is attached. The following 
program segment checks to see if the speech unit is attached. The program segment 
assumes that label RUN is where to go if the Speech Synthesizer is connected and 
label NOT is where to go if it is not cDnnKeti^k 



REF SPCHWT,SPCHRD 



PHROM DATA >0000 

HIO BYTE >10 

HAA BYTE >AA 
EVEN 

READIT EQU >8330 

CLR @PHROM 



Pointer to speech data. 
Read data command. 



Look at >0000 first. 



* Load address as described in Section 22.1.4. 



MOVB ©HlQjgSPCHWT 



Read data command. 



* Delay as described in Section 2!Z*1*1* 
* 

BL (iREADIT 

CB iSPDATA,(gHAA 

JEQ RUN 



Read one byte. 

Is it >AA? 

Run the program. 
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can find the address by looking it up in the Appendix or with your program. After 
you have obtained the address, load it using the >4X comnnand as described in Section 
21.1.4, and then use the >50 command to have it spoken. 

The addressea, of aU tsf the wot^. are Ufet©a iff tke s^fs^ndix^ Kor 

i^- #^1^88 .^jlf fehe word HELLO is >351A. The following program segment 
cau^s the computer to say HELLO if the Speech Synthesizer is attached. 

22.2.1 Aecessini u^t^ tHa Address from thd Appondlx 



* 


REF 


SPCHWT,SPCHRD 




HELLO 
» 


EQU 

s:m 


>351A 


Speech data address from the 
Appendix^ 


PHROM 
H50 

* 

WAIT 
* 


DATA 
BYTE 
EVEN 


>oom) 

>50 




Bt. 

MOVB 

COC 

JEQ 


@SPDATA,RO 

[iH8000,R0. 

WAIT 


Read from speech read data. 

Check on Status. 

Wait until finished speaking. 


* 


LI 

MOV 
LI 


RQ,HELLO 

R0,(3PHROM 

R2,4 


Load address, of HELtOi 
Four nybbles to load* 



■* Load address as described in Section 22.1.4. 
* 

* Delay as described in Section 22.1.1.. 

UmB @H50,I1SPCHWT Write execute speak command. 

* 

^ Delay as de^erifeed ifv ^^ecittcm 22.1.1. 
* 
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Z2.2.2 Accessing Speech Directly and by Finding the Speech Address 

V©u M s^ech datE ^^1^ ftn W^m^0ms W smtphinQ a 

table, lacatBd at the of ^ ^ee^ ^q^^eaizer^s m&mMFf^ fMt 1^ word tr 

phrase you need. The following list describes thie information for each word or 
phrase included in the table. 



U^m hmmtU Example 


ASCII Length 


1 byte 




Word or Phrase in ASCII 


n bytes 


>77 >79 >82 >69 ("MORE") 


Less-Than Pointer 


2 bytes 


>04B6 


Greater-Than Pointer 


2 bytes 


>0EB5 


Speech Data Pointer 


5 bytes 


>0O4642 


Speech Data Length 


1 byte 


>51 



The less-than pointer gives the table address of the information related to IP© word 
or phrase next in alphabetical order. The greater-than pointer gives Mm table 
address of the information related to the preceding word or phrase in alphabetical 
ordefi. 

In addition, you can load speech data directly in a program and have it spoken using 
the >60 command. 

In the following prngram, the entry point START looks up the address of the word 
"HELLO" in the Speech Synthesizer, The word is then spoken until a key is pressed. 
Control is then returned to the calling program. 

The pf^Ht 0;1RECT is an example of p^^s^rffcii the Speech %nlfK^fe^ Sfl^h 

direct data. When DIRECT is used, a phrase is spoken once. After it is spoken, 
control is returned to the calling program. 
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REF SPCHWT,SPCHRD*GPLWS,K5CAN 





DEF 


STARTjDIRECT 


PHROM 


DATA 


0 


DATAAD 


DATA 


Q 


SPDATA 


EQU 


>a32a 


READIT 


EQU 


>8330 


tu t' A 

RSA 


DATA 


M 


SSA 


A T It 

DATA 


n 

u 


H8QQU 


DATA 


>8000 


H4000 


DATA 


>4000 


HELLO 


EQU 


>351A 


SPEECH 


DATA 


118 




BtTF 






BYTE 


206,91,138,224,232 




n \/"ri — 

BYTE 


116,186,18,85,130 




BYTE 


204,247,169,124,180 
116,239,185,183,184 




wyTE,. 


rUfE -nfv ^ 

3^7t^>^32,l>l 




BYTE 


7^7,90,29,179 




BYTE 


6,90,206,91,77 




BYTE 


136,166,108,126,167 




BYTE 


181,81,155,177,233 




BYTE 


2]roA*,im,^6 




BYTE 


1,11,0,170,100 




BYTE 


53,247,66,175,185 




BYTE 


104,185,26,150,25 




BYTE 


208,101,228,106,86 




BYTE 


121,192,154,147,^ 




BYTE 


95,83,228,141,111 




BYTE 


118,139,83,151,106 




BYTE 


102,156,181,251,216 




BYTE 


167,58,135,185,84 




WPTE 


49,209,106,4,0 




BYTE 






BYTE 


59,176,192,3,0 




BYTE 


0 
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STRING BYTE 
TEXT 
H50 BYTE 
nm BVTE 
H60 BYTE 
HAA BYTE 
EVEN 

NOP 
NOP 
NOP 
RT 

CLEN EQU 
DIRECT 

* Put read routine 
LI 
LI 
LI 

DR2 tm/ 

DECT 

JH 

LI 

MOV 
LI 

MOVB 
BL 

LOOPR 

MOVB 

DEC 

JEQ 

DEC 

3NE 

LOOPS 

BL 

MOVB 
COC 
JNE 
LI 



5 

«LUP* 

>50 

|>1Q 

>60 

>AA 



^KHRDjtSPDATA 



on 16-bit bus. 
R1,READIT 
R2,CODE 
R3,CLEN 
*R2+,*R1+ 
R3 
DR2 

R2,SPEECH Pointer to speech data. 

*R2+,R3 Size. 

Rl,l& 14 Iftea lo load. 

[^H60,i§SPCHWT Speak external Gommand. 

(aDLYl2 



*R2+,@SPCHWT Send a byte. 

R3 

OUT Finished with data. 

Rl 

LOOPR 



@REAcrr 

dSPDATA.RO 

(iH4000,RO 

LOOPS Speech not terminated; wait more. 

Rl,8 Queue half finished; send more data. 
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■* 

START 

* Put read routine on 16-bit bus. 

LI R1,READIT 

1.1 R2,CODE 

LI R3,CLEN 

ST2 Mm 

DECT R3 

JH ST2 

* Check for existence of Speech Synthesizer. 

BL ©THERE 

GAW CM" 

* Start loc^i^ 1^ \^lidation byte. 

INC [aPHROM 

SEARCH LI R3,STRING 

MOVB *R3+,R7 

SRL R7,8 

OEQ OUT 



BL fLOAD 

BL §DLY42 

MOVB @H10,@SPCHWT 

BL 1DLY12 

BL @TO%mT 

MOV ©SPDATA,R4 

SRL R4,8 

INC (iPHROM 



Length of target string. 
Null string. 
Load speech data address. 

Read length byte of string. 
Make it a word. 



NEXT 



BL 




Address of next letter. 


BL 


[iDLY42 




MOVB 


[§H10,@SPCHWT 




BL 


@DLY12 




BL 


gREAOT 


Xefcte. 


m 


*a^l^DATA 


Does it match? 


JEQ 


MATCH 


Yes. 


JH 


HIGH 


Too high. 


3MP 


LOW 


Too low. 



EDlTOR/ASSEIim^R 

Page 359 



^EE CH 



MATCH 



HIGH 



STRH 



LOW 



NXTPHR 



* 

SPEAK 



INC 

DEC 
JEQ 

n 



3m 

CLR 

A 
A 

BL 

MOV 

JEQ 



MP 



U 

A 

BL 

BL 

MOV 

BL 

BL 

MOV8 

BL 

B 



gPHROM 

Mt 

STRN 

R7 

SPEAK 
R8,2 

NXTPHR 
R7 

NEXT 

R8 

R4,@PHROM 

R8,[iPHROM 

@DATAAD,R5 
OUT 

^^*BPHROM 
SEARCH 



RB,5 

RS^FHROM 
(3READ 

[aDLY12 

@DATAAD,©PHROM 

©LOAD 

@DLV42 

©H50,@SPCHWT 

[iWAIT 

©START 



More letters avaiiabie. 



Found the word. 



Skip one pointer. 



Do not skip pointer. 

Skip over rest of word. 
(Maybe) skip first pointer. 
Read two bytes. 

Word not found. 

Keep looking. 



Read address of speech data. 



L@a^' asMre^ of sp 



Speak word. 

Wait for finish (or exit). 
Do it; ail again. 
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SPEECH 



WAIT 







*iavp pfefriim address* 




lalRFADTT 


Read the status bVte. 


MOV 
ivlLJ V 


Sl^PHATA Rfl 




DL. W n 


lairNO* -rAi N 


»_> d 1 L nvL^VLJ^JCtt vJff 


MOvD 




Wdo d Key pi CoocU ; 




OUT 


Yes. Exit. 








JEQ 


WAIT 


No. Keep waiting. 


B 


*R10 


Yes. Return, 


LWPI 


GPLWS 




B 


@>6A 





* Read a word of data. 

» Address in PHROM, data returned in DATAAD, 

* Call with BL 

READ MOV R11,@RSA Save return address. 

BL (SLOAD Load the address. 

BL @D^_Y42 Wait. 

Move §H10,§SPCHWT 
BL @DLY12 

BL ^READIT Read first byte. 

MOVB ©SPDATA,©DATAAD 

Htm ^Hms^^^ 

BL ©DLYia 

BL ©READIT Read second byte. 

MOVB [iSPDATA,@DATAAD+l 
MOV ©RSAjRll Return. 
RT 

* ONo^ ito m& If &ie Speo^ Synthesizer is attached. 

* Called as BL ©THERE 

DATA <not there> 

THERE MOV Rll,(gRSA Save return address. 

CLR §PHROM Location 0. 

BL @LOAD 
BL §DLY42 
M QVB [§H 10 , @ SPCH WT 
BL @DLY12 

BL ©READIT Read the byte. 

CB liSPDAT^^HAA Is is >AA? 

RUN Yes. The peripheral is attached* 
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* Not there, 

MDV 

m 



*EU1,R11 



fetish date word ^ alternate returru 



* There 

RUN MOV 

mar 
nr 

* Load address. 

* Called as BL 

* Uses RO, Rl, and R2. 



@RSA,R11 

nil 



)LOAD with address in PHROM. 



LOAD 



taADLP 



MQV 
U 

SRC 

MOV 

SBC 



PHROM.RO 



DLY12 



DLY4tA 



MOVB 
DEC 
JNE 
U 

MOVB 
RT 
NOP 
NOP 

mj 

L% 
DEC 
JNE 
RT 




R2 

LOADLP 
FU,>4Q0Q 



Mal^ it >4X. 
Do it four times. 
Write me Mf^ 



Short delay. 



Long deia^f atfter address set up. 



Rl 

DLY42A 
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SECTION 23: THE DEBUGGER 



The Debugger program allows you to find errors in your program while it is actually 
running. You can read values in memory, write new values, inspect Workspace 
Registers and alter their values, move memory from one location to another, per^Krn 
Hexadeeimai arithmetic, and a variety of other funetions. Each function is easily 
available with a single-letter command. 

With many of the commands, you can enter a G or V after an operand to indicate 
that the operation is to take place in the Command Module GROM or VDP RAM, 
respectively, instead of in CPU RAM or ROM^ 

You can define up to three bias characters, labeled X, Y, and Z. When one of these 
characters is appended to an operand, its value is added to the value of the operand. 
Thus, if you have set X to >12A and enter an operand of >1B2X, the operand used is 

The Debugger 1^: loqated on the Editor/ Assembler disl<ette labeled Part A. In 
addition to the compressed object file, called DEBUG, the entire source listing of the 
Debugger is included. DEBUGS is the main program, consisting mostly of COPY 
directives; DEBUGA is the first 400 lines of the Debugger; DEBUGS is the second AOO 
lines; DEBUGC is the third 400 lines; DEBUGD is the fourth 400 lines; and DEBUGE 
is the fifth 400 lines. You should make a backup copy of these files. 

The Debugger program is a modified version of the TIBUG program designed to be 
used on a TI Home Computer. The Debugger is relocatable and can be loaded by the 
LOAD AND RUN option on the Editor/Assembler or with CALL LOAD ftmn TI 
BASIC. The Trnfrm of the file to load is E^KXJEMWa if m A 
is in Disk Drive 1. Since the Debugger is relocatable, it is suggested that you first 
load the program to be debugged and then load the Debugger. Then enter the 
Debugger and do the required set up so that you can return to the Debugger when 
dedi^ed. The Lt^de^ idac^ the Debugger program in memory the same way any 
other assembly language program is loaded. 

Follow these steps to access the Debugger from the Editor/Assembler. 

1, Insert the Editor^^^mfete Oatiirtmf^ Module tnm Hm msemii%, 

2. Press any key to make ttie master selection list appear. Select the 
Editor/Assembler. 
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3. Ins^t the Edlbar/Assembier cHakette that cont^m the Debugger {M-ogrfim 
(Pmt A) if^o Disk Dtive X, 

4. Select LOAD AND RUN from the Editor/AssemM^' selection list. 

gnCer tti» fiame of the program to be debugged. If th&t& Is no siich 
pro^m^ go tjo the next step. 

6* :tlpie DSKX-OEBUG (the fUe nmm ©I ^ Ctebi^«»), and <rBttim>. 

7. Pfs» <retutn> again tq advance to the nekt prompt* 

8. Z<nimr D^y^ m -Wm pro^m mm of iim DabuggK*. 

9. The i3abug§0r is loaded and ready to accept commanda. 
roUow these steps to use the Debugger from TI BASIC. 

1. rnsert the Eclltar/Assetnbler Command Module into the console. 

2. Press any key to make the master selection Ust appear. Select Tl BASIC 

3. Insert the Editor/Assembler diskette that (contains the Debuggo" program 
(Part A) into Disk Orlve I. 

4. Load the pmt^mt\ that you wish to debugs using the CALL LOAD atetement. 

5. Execute CALL LOAD C"DSK1,DEKX?*> from Tl BASIC. 

6. Execute CALL LINK<"DEBUG*^. 

7. The Debugger is loaded and ready to accept commands. 

llfliB^ li Itie Debugger is entered fmn ft SAI^f^ yoit ^lai^d Invmedlati^ sete^ ^ 
U command so that the di^lay is correct. 
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PRELIMINARY irsFORMATION 

PressLr^ j^flMetter commaiKis 3©ssee!Sffi^ tm^^m The Cteta^i^ 

automatically places a space after the letter, although you cannot see it because no 
cursor appears on the screen. Do not press <space> following the command letter 
unless you intend to terminate the command. 

Mwt ehtm^^ ihn m&tuw&ieid^ ^ tiQmmdnd*^ Oji^iEM^, mMn &m^0- of up 

to three hexat^^fHSil fields, depeticling m fcht HdWrtmand. Operands contain four 
hexadecimal digits each. If you enter more than four digits, only the last four are 
used. If you enter fewer than four digits, they are considered by the Debugger to be 
the right-most digits of the operand. 

The following are the Debugger commands* 



Command 


Letter 


Section 


Load Memory with ASCII 


A 


23.2 


Braskp^nt Set/Clear 


B 


23.3 


CRU Inspect/Change 


C 


Z3Ji 




E 


23.5 


Find Word or Byte 


F 


23.6 


GROM Base Change 


G 


23.7 


Inspect Screen Lcr^l^uh 


I 


23,8 


Find Data Not Equal 


K 


23.9 


Memory Inspect/Change 


M 


23.10 


Move Block 


N 


23.11 


Compare Memory Blocks 


P 


23.12 


Quit Debugger 


Q 


23.13 


mmmt m t^mm wp, pc, and sr 


R 


23.14 


Execute in Step Mode 


S 


23.15 


Trade Screen 


T 


23.16 


Toggle Offset to and from TI BASIC 


U 


23.17 


VDP Base Change 


V 


23,18 


Inspect OS! Change Registers 


w 


23.19 


Change Bias 


X, Y, or Z 


23.20 


Hexadecimal to Decimal Conversion 


> 


23.21 


Decimal to Hexadecimal Conversion 




23.22 


HfS^^lMl i^rt^etie 


H 


23.23 



Each command description consists of the following information. 
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a A headin0« conaisting of the command name^ m^tf emvi^tnd letter 

p The i^ti^ deMtiisn 

o An example of the command 

o The definition of the cotmnwd 

In the syntax definition, the following Rotational conventions are used. Items 
surrounded by <angle brackets> represent keys or items that you must provide. Items 
iSiB^mded by {braces} indicate that you must choose between the two or more items 
ineiuded. Items surrminded by [bra^et^ indicjate optldnal matsHal. Thm eli^ls (..*) 
indicates tfmt the prttl^s item rm$ be tep^ted. 

Note: In the Debugger, the <escape> key is not the same as the <esc> key used in 
the rest of She Editor/ Assembler. The <escape> key is SHIFT X on the TI-99/4 and 
FCTN X on the Ti-99/4A. 

In the example and definition the ctJnti.fTi«imiiBj tJm intermtion you tyfie is 
underlined. 
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23.2 LOAD MEMORY WITH ASCII— A 

Syntax s^^i ticBi! 

A<start address><return> 
<ASC1I string><escape> 

A lDO0<return> 

1000 NEW vyQRDS<escape> Places the ASCII string NEW WORDS in nwTOiy 



Places the ASCII string In memory starting at the given hexadecimal address. 

Any information, including <return>, that is typed before <escape> is placed in 
memory. After each 16 (>1Q) bytes, the current memory location is shown on the 



starting at address >iOQO. 
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233 BREAKPOINT SeT/CLEAR— B 

Syi^tax def initic^i^ 

• To set a breakpoint! 

• To clear a breakpoint 



m To shew br^kpGlrrtas 

B<return> 
■ To olear all breakpoints: 

B<-> 

Example: 

8 AQ(]N)<rBturn> Sets a breakpoiftfc to be pert OTined at address >A0OO- 
Definition: 

Sets a breakpoint to be performed at the given address if B is foliowed by an 
address and <retuin>, Clems a bremkp0lnl if B Jis f&Uwed 1^ m ^ddi^s? arid <^>. 
Shows all breakpoints if B is fallowed by <return>. Clears all breakpo^ts if B is 
follpwed by <->^ 

From 11 to 16 breakpoints can be set at the same time, depending on your 
compute. When a b£«E^^iaM is eneotK^^emt t«ei^^i?ni to w^wfsism 

f^aist^. pm^^mm' estw^, ar«I ^ato are sasedi ttte Wmk^'mt it cleared, and tb^ 
O^tigier is ^nteed. 

Setting a breakpoint replaces the contents of the breakpoint address with an XOP 
1 £^ '-^W^. m a t«w»^ to KNTO^ (few® wmd&h H lEormal© cteea mit 
m$^^0i^ .Xf #ie EJebug^er aatmmMcsaly iises the tw^wsord BEHTRY arpd 
pdTovides the me^^e 

BKPT USES 2 WORDS 



EDITOR/ ASSE MfflJER 
Page 368 



THE DEBUGGER 



Some TI-99/4A computers Support XOP 1 and some do not. If you get the 
message BKPT USES 2 WORDS when you enter a breakpoint, yours does not. 

If your computer uses two-word breakpoints, you mya* ^afe^^!^^ §0Si^e^^ 
precautions. Firat, jj^su cannot set breakpoints at consecutive wordis. If you 
atteinpt to do so, Ehe following message is displayed. 

ILLEGAL CONSECUTIVE BREAKPOINT 

Second, under some circumstances the computer may interpret the address eif the 
Debugger as an instruction. For instance, suppose your program reads as follows. 



ADDR 
LOOP 



JMP 
MOV 
DEC 
JGT 



START 
R1,R2 

LOOP 



Code 1010 
Code CQOl 
Code 0603 
Code 15FD 



START LI 

JMP 



R3,6 
LOOP 



Code 0203 
0006 
Code lOFO 



If you then set a two-word breakpoint at ADDR (assuming that the address of the 
Debugger entry is >B062), the program becomes 



ADDR BLWP §BENTRY Code 0420 
LOOP Code B062 

DEC R3 Code 0603 

JGT LOOP Code 15FD 



START LI R3,6 Code G203 

0006 

a MP LOOP Code lOFQ 

When the program executes the JGT LOOP instruction, it interprets the address 
of SENTRY as an AB instruction. This situation can be avoided by not inserting, 
breakpoints where the second word is a label. 
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In twm-w^tl breakpoints the previous contents of the memory are saved. 
Ciem'iTig a bre^pdtnt pestclres t^ orifinal xmntimfcB of rtm^S^ tee^ti05.= If 
ix^kpi^t is set mcM^e than once ^ the sa^ne location, the f dildwirig message is 



The ^ow brestt<|30irit «Mf¥m^ B^^umh ^Ims mitk&^s Qf t}*e euJiPeist 
hreakpokits In the order In ^Mdh they were set. 



ILLEGAL CONSECUTIVE BREAKPOINT 
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25.4 CRU INSPECT/CHANGE— C 

Syntax definitiont 

C<base sddress>{<space> or <,>}<bil; count><Feterv> 
[<data>][<return> or <^ace>) 

C 13iQJ<getugn> Gives the value of the least-significant CKU bit at a«Ures$ 

>i38a. 

Defbiition: 

Qiv^ ^^1^ niMf!rSI«e|* erf ^^M^ II specify 1 lhrQi«#i 

15 bits, that many bits are returned as h^M^dii^nli^ him^^^. If i^p»eci^y G 
as the bit county 16 bits are returned. 

tei^ CMJ bit takes up two bytm m the CRU. For example, supppcse the CRU 
is as shown in the following tables 



CRU 




CRU 


Bit 


Value 


Address 


0 


1 


Hjm 


1 


Q 


>1382 


2 


X 


>1384 


3 


1 


>13B6 


4 


a 


>1388 


5 


1 




6 


1 


>138C 


7 


0 


>138E 


B 




>1390 


9 


@ 


>13?2 


A 


0 


>im 


B 


0 


>X396 


C 


1 


>1398 


D 


Q 


>139A 


E 


1 


>139C 


F 


0 


>X39E 
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Then if you give the command 
C 1380,1 

The Debugger returns 0001. If you give the command 
C 1380,5 

The Debugger returns OOOD. If you give the command 



the Debugger returns 006D. If |S^e the command 
C 1380.0 

The Debugger returns 516D. 

The C .osmmand uses the STCM mmi LDCR instructions. Tor more information on 
these instructions, see Sections 9 and 24.3.2. 

The corresponding CRU output bits can be altered by inputting data in the same 
format Hiat is gi»wi by the Debugger. If a change is Wlowed by <P©tiiE^j 
omim^ is rstwtd '%n ^ C^i^gger. If a change is followed by <space>, the 
CRU input bits are displayed again. 

Reading CRU data immediately after changing CRU data at the same address 

Mjt always give ^e £^me value because the CRU input and output may not 
have the same hardware configuration at the same address. 

For example, the Disk Drive Controller CRU address >11D0 is designed to enable 
the disk Device Service Routine ROM. This is a write-only CRU bit, so there is 
no input circuit. Performing an SBO instruction on address >1100 enables the 



I3^ij£Sll Service Routine ROM, However, reading CRU output data from address 
>1100 gives meaningless data. 

In addition, in some devices, such as the clock, bits may be altered by the time 
the CRU bit is read after writing to the CRU. Thus, the same data cannot be 
read even though you write the data correctly. 



C 1380,8 
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23#5 EXEaJTE— E 

Syr^ax definition; 

E[<address>]<return> 
Example: 

E 2P0Q^return> Enters the program with the parameters defined by the R 

command, starting at address >2000. 

Definitions 

Enters the program with the parameters defined by the R command, starting at 
the address provided. If the optional address is entered, execution begins at that 
address rather than at the address specified by the R command. Normally, you 
should use the Q command rather than the E command ttie <B mtMnm^^ 
restores the screen and updates the screen offset, VDP address, and screen width. 
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23,6 FIND WORD OR 



Syntax definition: 



F<start addres5>{<3pace> or <,>}<8top addrBas>{<8pace> or <,>J<data> 
{<return> or <->} 



Examples 



r 200Q 30Q3 AFXO<raturn> 



Compares the data in addresses >2000 through 
>3003 with >AFiO and displays the addresses and 
contents of those that match. 



Cfefinition: 



Compares the values in the start address through the stop address with the values 
given by the data and displays the addresses and contents of those that match. 
If the final entry 19 <return>, words are compared. If the final entry is <->, 
t^feEis 0igcifpmd. If wordd are compared^ ^ &i^i^Mm 'U fmemMed % t 



before the next comparison so that comparisons are made on word boundaries. If 
a byte comparison is performedf the addre^ is only incremented by one after 
each comparison. 

A C m V can be mte^ at ti>e mt^ of the stait addi^ss to indioa^ that the 
comparison should be made at M s^il^ li Sr^^W^ ms^M^^^f r^er 

than in CPU memory. The F command is the oppo^te of the K ©omrr^d. 
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23.7 GROM BASE CHANGE— G 



Synta>£ definition! 



Example: 



G 



Causes the current GROM Read Data address to be displayed. It (San 
then be altered. 



Definition: 



Ufif^^ fJresent GROM Read Data address. This address can be altered by 

%fj0i^ ^M^^^ ^tired and pressing <return>. This procedure allows yoi 

to use the commands that access GROMs or GRAMs to be used in the GROM 
library memory areas or any other GROM address spaces. The read and write 
addresses are >1000 apart. The default address is >980Q. 

Notex This command Is not useful unless you are developing special hardware* 

For example, if you enter G, the response is 



You can then enter a new address if the device i& a GRAM "or press <return> to 
accept the address. 




GROM BASE = 9800 
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as-a ifc^PECT sc;re^ location— i 

Syntax definition: 
I 

£<new sicarfeen a£idresa>]<reten^ 
[<new screen □ffset>]<retum> 
[<new vyidth>]<return> 

I Displays the previous beginning: 

VDP SCREEN ADDRESS = 0000 <return> screen address and accepts it, 
SCREEN OFFSET = 0000 60<retOCTi> Displays the previous screen offset 

mWTH {>m or m) « OOZO <return> and change? it >W0- D^ays 

th6 previous wi^th an^ accepts it. 

Definition: 

Displays the current beginning screen address, screen offset, and width, and 

allows ^ m tugm Tlie sereen te^^' lwm§B( T«iM rmmm&f 

starts at VDP address >0000. To move this table, you inform the Debugger with 
the I command. Note that the Debugger does not change the VDP Registers. It 
sets up a temporary word that contains the nev/ address. The Registers are 
changed the vm%% ^ei Debugger is entered a ^^^stot. ttw 

^ in #^Mr- m |if ' UfM Ifmm ti basics m 

LOAD AND HVH Option (tern tfm Editor/Ai^embl^), the changes are not madeu 

The screen offset is useful if you are using Ti BASIC because the ASCII values 
of the ti BASie? mrm^ ^^rpi^a^ ape offset by >60. 

If y<sjr program is running in text mcKie, you can sgt the «:reen width to >Z8 
rather than the default of >20. 

The f€^m»^0 <mm^hei shows the use of the I command to <^angt the sm-een 
addpj&sg to >d4%$ the screen offmt to >60, and the widlii to >28. 

I 

VDP SCREEN ADDRESS = 0000 400<return> 
SmEEM OFFSET = 00EB3 6Q<return> 

WIDTH (>20 m m = MO 2B<returtO' 
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23.9 FIND DATA NOT EQUAL— K 

Syntax definiUom 

K<start address>{<space> or <,>}<stop address>{<space> or <,>}<data> 
{<return> or <->} 

Example: 

K 2QQ0 2100 AF10<return> Compares the data in addresses >2000 through 

>2100 with >AF10 and displays the addresses and 

Definition: 

Compares the values in the start address through the stop address with the values 
given by the data and displays the addresses and contents of those that do not 
match. If the final entry is <return>, words are compared. If the final entry is 
<->, b^t^^ are compared. If words are compa^^dr the address is incremented by 
two before the next comparison so that comparisons are made on word 
boundaries. If a byte comparison is performed, the address is only incremented 
by one after each comparison. 

^ S m H can be entered at the end of the start address to indicate that the 
ooiT^ai^lm should be made at the address in GROM or VDP, respectively, rather 
than in CPU memory. 
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Z5.X0 MEMORY INSPECT/I^ANfaE— M 

Syntax definiti^itisi 

B To m& tit altOT a tmmnty teafciens 

M <address><return> 
[<data>}[<return> or <3pace> or <->} 

• To ^ee mUUple niemdry locations: 

M<start address>{<sijiaeiS!> or <,>}<stop address><return> 

Examples: 

2Q00<return> 

2000=1000 A35C<retuin> Changes the values in address >2000 from >1QOO 

to >A35C, 




ad^e^aes >ZOQO through >ZJ.ao and th^ir 



Definition; 

Di^l^ l^e addre^ and its value It a sir^ie address is given. If a sts^t add^e^ 
and stQp atfcireas ars ^Iveo, displays the addre^es and their values. 

If a single address is given, followed by <return> and a value, that value is placed 
in the addre^. If a change is followed by <return>, control is returned to fttwfc 
PetKULli^p^* If a change is followed li^ <j^iE^^ the next addre^ and its value are 
di£^ayed and you can change that value. If a change is followed by <->, the 
previous address is displayed and you can change it. Note that entering a change 
followed by <space> <-> allows you to check the memory location that you have 
Jwst changed. 

The following example shows how to change the value in address >4042 from 
>1Z34 to >5678 and then check the change. The example assumes that address 
>4044 contains >CDEF. The final <rBturn> returns you to the Debugger, 
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M 4042<retum> 
4042 = 1234 567B<spaGe> 
4044 = CDEF <::>_ 
4042 = 5678 <i;eturn> 

If you choose to see multiple memory locations, each line of the display consists 
of the adClress of the first memory location foUowitf 1^ it '^^^ of data atid tim 
j^KH i:i^!?B^^^i^^ if the data with en ai^t^^ {) far the unprintable 
characters. The display process can be halted by pressing <escape>. Press arty 
key to stop a list of memory locations temporarily and press a key again to 
resume the list. 

A G or V can lie entered at the 6nd of the start ddtic^ 1^ Indicate that the 
comparison should be made at the address in GROM or VDP, respectively, rather 
than in CPU memory. When GROM or VDP memory are being addressed, data is 
accessed and altered one byte at a time. Only addresses >0000 through >3FFF of 
VDP RAM can be accessed. GROM cannot be altered. 

Note: Even accessing GROM can alter the GROM proQrani ctiunter* preventing 
correct return to your program. 

Tq c^mnrgs a register, enter an address ^f V8 followed by the register number 
CO through 7), the data byte, and <return>. For e>^wtplt, the following load^ 
Register 1 with >60, 

M V616Q<return> 

Note: You cannot read VDP Registers; you can only write to thenv 
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23.11 MOVE BLOCK~N 

S^tax definititmt 

N<frQm address>{<spacB> ac <^>}€tti a^res8>{<space> or <,>}<byte count> 
{<retum> or <->} 

Example: 

H 2D0QV COOP 10D<f efairr^ Moves the 100 bytes starting at address >2000 in 

VDP RAM to the 100 bytes starting at address 
>C00O in CPU RAM, 

Moves the number of bytes speoltie^. If the command is termirmted with 
<return>, the bytes are transferrad ifi the following order, 

To Byte 

to address + 1 
tl> address + 2 

■*. 

ti3 address 4- byte count * 1 
<->,, the bytes transfer in the following order. 

to dddress + byte count - 1 

£a &^s^ms$ + byte count - 2 
eddre^ * byte count - 3 

« 

tti ^ddrei» 

With the first method, you can effectively copy the same byte into several 
consecutive memory locations. For instance, if >13 is in address >2000, the 
following command places >13 in addresses >20QO through >210Q. 

M mm 2mi xoo<retMrft> 



From Byte 
from 
frorn address + 1 
address -i- 2 



fjpom addr^ + l^te ^aunt - 1 
If the cornwr^ is terminated with 
From Byte 

from acfcireas + 6yEe count - 1 
t^mn aiJdreas * count - 2 
from address + byte count - 3 
> 

from addre^ 
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COMPARE MEMORY BLOCKS^ 



Syntax dellmtiom 




or <^i}%tart acfelrdisat 2>{ <^38c^ or 



Examples 



P 2050 ?OQQQ lOD<rBturfO 




Definition: 

Compares the number of bytes given in byte count from the locations starting at 
start adtfresa 1 to the loeationa starHtif at start adcfran 2 and pi^& the 

addresses whose data do not match and what is actually in those addresses. A Q 
or V can be entered at the end of start address 1 or start address 2 to IndicaJbB 
that the comparison should be made with the address in GROM or VDP, 
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Z%1> QUIT PEBUGGER-GI 

Syntax deTOtion: 
Q<return> 

Q<retiJrn> Leaves the Debugger and executes the program whose 

parameters were defined by the R command. 

Definitions 

Leaves ^ iMn^fiE^ isei^ores the screen, updates data ente^gd ^ I: 
command, and executes the program whose parameters were defined by the R 
command. If the Program Counter is equal to >0000, the Debugger returns to 
the Editor/Assembler screen. You can then run your program with either the 

Lom mo mm m kun option. 



EdrrOlVASSEMBLER 

Page 382 



WE DEBUGC^R 



23.14 INSPECT OR CHANGE WP, PC, AND SR—R 

R<return> 

[<data>]{<return> or <space>} 
[<data>l[<return> or <space>} 

R<return> Shows the Workspace Pointer value and allows you to change 

It. 

Definition: 

Shows the Workspace Pointer, Program Counter, and Status Register and allows 
changes to be made in their values. After you open a register, you can change 
1%. *them pmsB ^%g£ytis> reten £ci the P^^|^ or ^#^1^!^ tfm mmt 

rctgi^f^ fm mspe£^tion dr change* 

The Workspace Pointer points to the program workspace. The Program Counter 
paints to the first instruction of the program to be executed. The Status 
Register contains the stista the prograrru These values are passed to #ie 
pro-am when ti^st D^ugger comman^d E^j ^ $ me execatpcL 
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23.15 EXECUTE IN STEP MODE-S 



Nn^N^ E3{BE5^tmg a progpsHB tsns a* s tim& requires spe«#al fes^rteare; h not 
available for the TI Hms Dijmputer, Without this special hardware, the S cQmrnanci 
has the same effect as the E command* 

Syntax definition: 

S[<step eount>]<return> 

Example; 

S<return> Executes one step in the program and returns control to the Debugger* 
Definition: 

With the special hardware required, enters the program with the pnrameters 
defined by the R command, executes step count steps, shows the values in the 
Workspace Pointer, Program Counter, and Status Register, and returns to the 




^Sount is omitted, the default is 1. 



Caution should be used when single-stepping through a section of your program 
that sets up VDP write addresses because the Debugger also changes VDP write 
addresses. You should also avoid single-stepping through code which accesses the 
GROM because of possible ultismtt^m to tfife CsS^OM program counter. 
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25*M Tmmx SCREEN— T 
Syntax dBtinitionJ 
T 

Example: 

T Trades the Debugger screen for the screen as it was when the program 

stopped at a breakpoint. 

Definition; 

Ii^Sl©8 ^ t]tei»jggep BEJreen for the scre^ ai \l She program stopped at 

a breakpoint. You remain in the Debugger and can continue to use the Debugger 
commands. However, using commands again scroils the screen. 
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25-X7 TOC3GLE OFFSET TO AMD FROM TI BASIC~U 

Syntax definitiom 
U 

Examine; 

U Changes the offset by plus or minus >60. 



Clwgi^ thm screen offmk 6^ plus or minus >60 to allow you to alternate 
displaying the screen as TI BASIC uses it and as the Debugger uses it. The 
ASCII characters used by TI BASIC are offset >60 from the way in which the 
Debugger uses those characters. 
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VDP BASE CHANCSE-^ 

Syntax definition: 

V<address><return> 
[<data>]<return> 

Example; 

V<|jeteyi> Causes fsresent VDP Read Data address to be dis^kiyad^ 

The adtfress mm% ^ altered by typing a new address and 
pressing <return>. 

Definition: 

cmms tte pm«. nm^ Dgta s^^a*^ displayed* Ttta «da»e«s » be 

altered by typing a new address and pressing <return>. This procedure allows yoti 
to use the commands that access VDP to be used in the VDP library memory 
areas or any other VDP address space. The read and write addresses are >10QD 
apart. The default address is >8800. Notes At present, no alternate VDP 
memory spaces exist. 

For example, if you enter V, the response is 
VDP BASE = 8800 

You can then enter a new address or press <rBturn> to accept this address* 
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23.19 INSPECT OR CHANGE REGISTERS— W 



Syntax definition; 



W[<register number>]<return> 
:'Bturn> or 



Example; 



W <return> Displays all of your Workspace Registers and their values. 

Definition: 

Displays all of your Workspace Registers and their values if no Workspace 
Register number or data are given and the command is followed by <return>. If 
« Wtmi'^i;^^ Megist«r number is given, it and its value are displayed and the 
value can be changed. After changing a value, you can press <return> to return 
to the Debuggi^^ )3^ss <space> to dis^l^ tNs fmt Mrkspace ^ 'Hb 

value so that you can alter that value, or press <-> to display the previous 
Workspace Register and its value so that you can alter that value. 
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25.20 CHANGE BIAS--X, Y, OR Z 

SfntSK cieflnitions 

■ Change X bias: 

X<value><return> 
• Change Y bims 

Y<value><return> 

■ ChMit^e ^ bias: 

Z<value><return> 

Example: 

Y 54<retuFn> Changes the Y bias to >34* 
Definition: 

Changes the X, Y, or Z bias to the value given. After a value is assigned, you 
can give ||$b eteaeliers X, Y, an4 % ferflowing an address in any is^hm mmm0^ 
and al^ #^,t M ^ s^Hl^nt S-f t«f If the reauU pf the alteration 

is an odd value, th^ actual addpess displayed is the next iQwei^ valu©* 

For example, if the Y bias has been set to >34, the following M command displays 
M lDgY<rBturn> 
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23.21 HEXADECIMAL TO DECIMAL CONVERSION— > 

Syntax definition; 

Xhe^cadecimal vala^<^s|*ace> or <return>} 
Exanopie; 

> 34<space> Displays the decinnai value of >34, which is 52. 

Definition; 

Displays the decimal value of up to four hexadecimal digits. Values of >8000 to 
>FFFF are interpreted as two's-complement numbers and are thus given as 
negative decimal numbers. 
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Z:>.22 DECIMAL TO HEXADECIMAL CONVERSION—, 



Syntax definitions 



.<decinnal value>{<space> or <return>} 



Examplet 



. 52<8pace> 



Displays the hexadecimal value of 52, which is >34. 



Definition: 

the hexadecinrjal value of any decimal value ftmt ^MlM thf^Uih 0$Mi> 
For negative numbers the sign precedes ths rWDta^* W£ies less than 0 are 
returned in two's-compiement form. Thus, both the value 655>5 and -327fifi are 
returned as >FFFF. 
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23.23 HEXADECIMAL ARITHMETIC— H 

Syntax definition! 

H<first number>{<space> or <,>}<secdnd nufT)ber><return> 
Example: 

A 6<return> Displays the sum, difference, product, quotients and remainder 
of >A and >6. 

Definition: 

Displays mmf diffmmG^^ ^^rostet, md tfel^ gisfft'oer 

and second number, Euch hexadecimal number can have Up tO four ditfits* Xti 
the example, the information is displayed as follows. 

H1=0QDA HZ=00Q6 m^hB = OTO 
H1-H2 « mm H1*H2 = 0000 003C 
HX/H2 = QOQl R 0004 
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SECTION 245 APPENDICES 



: he following are the appendices contained in this section. 



Ap pendix Section 

fsto^^lsg Systems and Organization 24.1 

Memory Organization 24.2 

Memcry, CRU, and Interrupt Structure 24.3 

Comparisons with TI Extended BASIC Loader 24.4 

SAVE Utility 24.5 

^ll^t^ ByiSfehesizeT Resident VoCabt^?^ 24,6 

Character Set 24.7 

Assembler Directive T^ible 24.8 

Hexadecimai Instruction Table 24-9 

Alphabetical Instruction Table 24.10 

Program Organization 24.11 
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24-1 NUMBERING SYSTEMS AND ORGANIZATION 






followed by a description of the byte and word organization in the TI Hortie Computer 
and the two's-conr^lement representation of negative numbers. 

24.X.1 Binary Number System 

The number system we commonly use, using the digits 0 through 9, is known as the 
decimal system, or base 10. In a decimal number, each place value represents a 
power of 10. For example, the number 1111 in the decimal system represents the 
fdliov/liiig^ 



1111 = a X 10^) + (1 X 10^) + (1 X 10-^) + (1 X 10°) 

The binary (base 2) number system uses only the two digits 0 and 1, In a computer, 
represent b»u #e^tarn^ &fi mti m-, ptee nf ' ^rm^ 



misfi^mt ^Bfgt^mn^ a poMiar ol bum* For example, the number 1111 in the binary 
system is interpreted as follows. 



The decimal numbers 0 ^twmj^ X5 can ea^ %e i^p^^iented by a four-digit binary 
number as shown in the foUowing table. Each four-digit binary number corresponds 
to a one-digit hexadecimal (base 16) number, represented by the digits 0 through 9 
and the upper-case letters A through F. 




llll^ = a X 2^) + U X 2^) + (1 X 2^) + (1 X 2°) = 15 



10 
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m in 
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7 


0111 
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9 




Q 
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A 


11 


1011 


B 


12 


1100 


C 


X3 


1101 


D 


14 


1110 


E 


15 


1111 


F 



24.1.1.1 Hexadecimai Notation 

t^m h»xift(le6lMl (^1^ l^il nuifibering syst^ ts sfien used as a comiK^ant stiorthand 
method far ts^mssnUn^ binary nttmbeiss. ^ tha p®&^te» fea^le ^mmt any teir^^^gil 
binary number can be represented by one hexadecimal digit. In this manual (and in 
Assembler source statements), hexadecimal numbers are preceded by a greater-than 
sign (», 

MiMng SdaiMt^ the relaUonship between a binary number and its 
hexadecimal equivalent. 

0010 1010 0001 1110 ^ >2A1E 



^4.1^2 Byta drganizatton 

A bit (binary digiO is the smallest unit of computer information. It corresponds 
directly to the electronic circuitry of the computer. A bit is either on or off, and 
thus can be used to make either/or distinctions. For example, a bit can distingMish 
between yes or no, up or down, on or sff^ ^sm m ppro, qr any two oppo#itea% Bits 
are usuglly represented in the binary number aystem. 
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Four bits equal a nybble and eight bits -at A byte is the smallest 

atJdressable unit of ^itatiation in the Hoiw Cesj^:^^^, ill fchf IfeP^ 0@mfSlEep» ^ 
most-significant (left-most) bit (MSB) is designatiBcI aS bit 0 and th^ tmSt sic|nificarit 
(right-most) bit (LSB) is designated as bit 7. 



Memory Byte 
(MSB) (LSB) 
felt 0 12 3 4 5 6 7 



24.1.3 Word Organization 

Two bytes, or 16 bits, of memory constitute a word. The computer can process a 
maximum of one of information at a time. In the Home Computer^ l^e most 
significant bit (MSB) of a word of memory is bit 0, while the least significant bit 
(LSB) is bit 15. 



Memory Word 

(MSB) (LSB) 
bit 0 1 2 3 4 3 6 7 8 9 10 11 12 13 14 15 



The 16 M a word can represent such things as a machine language computer 
instruction, a memory address, the bit configurations of two characters, or a number. 
If the contents of a word are to be interpreted as a number, the number may be 
tetepi^^d m a signed fM^nfe^ ll* ttm range of -32,768 through +32,767 of &s an 
tmstgn^ mrtsa? 'm ^ I'afi^ of i teat^h ^5,535. Signed numbers are designated in 
twoVcomplement form. See Section 24.1.4 

Each word begins at an even-numbered address (location) in memory. The 
even-address byte contains feita § through T ef kirn word, and the odd-address byte 
contains bits 8 through 15. When word inductions address an odd ^t&f tiie 

mast begin on a word boundary. Instructions are 1, 2, or 5 words IcHTg. 
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24.1.4 Two's Complement 
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53 035) 

2*3 complemBnt (-53, >CB) 



In the Home Computer, negative numbers are represented in two's-complement form. 
In two's-compiement form, the left-most bit of a computer word is designated as the 

U% \vhich indicates whether the number is positive or negative. The sign bit 
does not function as a part of the value of the number but only indicatefs positive or 
negative, 0 or 1, respectively. 

The binary number to be subtracted (the subtrahend) must be "complemented" by 
changing all the O's to i»s and all the Vs to O's. Then I It Sd£N to the 
complement blnas^ miit^^ ftt tfm f^m^fement. The following examples 
show how to find the two's complement of 26 and 53. 



00011010 26 OlA) 00110101 

IIIDOIOI complemented llTOOT 

+X plus 1 +1 

11100110 2's complement (-26, >E6) 11001011 

Notice that the bit at the far left of the byte (MSB) is always 1 when a negative 
number is represented. Conversely, the MSB is 0 if a positive number is represented. 

Wfvm pm^f&mS^ mM&^tkm^ tim mm^^ converts the tslw^ Eit^^^ tm ib@ 

subtracted to a negative number by using two's complement and then adds. In the 
previous example, 26 (nnflUOlO^) was converted to negative 26 (IIIOOIIDJ or the 
two's complement. The fallowing example demonstrates how to subtract 26 from 53. 

00110101 tJOllOlOl 53 >35 

-00011010 becomes +11100110 or -26 + >E6 

100011011 27 >1B 

The answer is 1101l2> °^ 27, wSth the ninth digit disappearing because i^f e byte 
arithmetic operation the computer recognizes only eight dibits in one b^tBi leaving 
the correct answer of OQOllSli^ 



24.2 MEMORY ORGANIZATION 

Ti £rA^^^ WMn^ st^nization, you must understand some basic t^ms and how 
the^ stpply to the Tl Home Cornputer. 

The Central Processing Unit (CPU) of the computer contains all the circuitry for 
arithmetic functions, comparisons, hardware registers, and all ofeh®? fcinetlans Wmt 
^^aily process computer instructions. The CPU processes all 0OMm^n^ Ml 
instructions fed into the computer and &^^M^s$- all memory spaces. The CPU in the 
Home Computer is the TMS9900 Microprocessor. 

One way to divide memory is into RAM (Random Access Memory) and ROM (Read 
Only Memory). RAM is a memory which can be written to, or read fromj ^ an^ 
program. It stores programs and data. ROM is a memory which can only be read 
but not altered by any program. It is used to store information used by the 
computer itself, such as the built-in TI BASIC language and the makeup of the 
alphanumeric characters, 

S# Wmt fm nm mfm any speeifie byte in the w^^y It 

assigned a number. These sequential called the addresses of the bytes, are 

unique within each of the computer's memory spaces. They are usually referred to in 
hexadecimal notation. 

Th® TNS9900 micsr^m^mff has an address ^mee of 64K bytes. In itm fr^mm 
Computer, some of this address space contains RAM and some contains ROM. In 
addition, some addresses are used for access to special devices, such as sound and 
speech, and to other areas of memory, such as VDP RAM and GROMs. 



24.2.1 Directly AdilreBBabla Memory 

When all possible devices are connected, 64K (65,536 or >10000) bytes of memory are 
directly addressable. 

Addresses >0000 through >1FFF are built into the console. They ^anfcain 8K bytes of 
ROM that contain the TI BASIC language and other information necessary to the 
functioning of the computer. 

Addresses >2000 through >aTF are the 8K bytes of RAM that make up the low 
M«»tttilE?|f ^ tf© y^mMf' &^^smioT) unit. They can only be used when the MemcH'y 
Expansion unit is connected. 
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Addfe^es >4000 th«#T ~^^F^ mm tft^i ttm metwm ^gflp*ieral& tH&f eentfc^tn up to 
8K bytes of ROM for the Device Service Routine used to run peripheral devices, SUC^ 
as disk drives and printers. These ROMs are selected by CRU operations (see 
Section 9), so several ROMs can be at the same address. 

Addresses >6000 through >7FFF am a^i^lahie on the Command Module port. Some 
Command Modules, for example Tt Extended BASIC, have ROM in thia spaca* 

Addresses >8QQ0 through >9FFF are built into the console. They contain PAD from 
addresses >8300 through >83FF (see Section 24.3.1) and all of the memory-mapped 
device locations. 

Addresses >A00O through >FFFF are the 24K bytes of RAM that make up the high 
rnornory of the Memory Expansion unit. They can only be used when the Memory 
Expansion unit is connected. 

The following memory map summarizes the above information. 



>0000 

>200Q 
>4000 

>6000 

>aoQo 

>AO0O 
>FFFr 



CPU Memory Use 
General Case 

+ _, _ , 

I (Console RGM) [ 

I Two 4K RCM chips 1 

4— - + 

I Low Memory Expansion | 

+ + 

I Peripheral RCMs (mapped) [ 

1 for Device Service Routine | 

+ „ + 

I Application ROMs in Conmand Module i 

+ -- -- 

I Memory-mapped devices for | 

I VDP, GROM, Sound, and Speech | 

i PAD at >83Da | 

+- + 

! i: 

I High Memory Expansion | 

I \ 
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When the LOAD AND RUN option of the Editor/Assembler is in use, the following 



CPU Memory Use 
LQ^ RJN Option from the Ed i tor/Assefffel 

>0000 + + 

I (Console RCM) I 

I Two 4K RCM chips | 

>2000 +.-^^-*-*- - + 

1 Low fvlWEs^y & i [. 

I Loader, your progr am ^ I 

1 and REF/DEF Table | 

M0:13-Q' + - + 

[ Peripheral RQMs (roppp §d ) I 

f fm Device sef^l^^ r^mlnn \ 

>6qoo + — ------- + 

i Una va i 1 ab 1 e 1 

> aooa +--,^ — -.^ 

[ Memor y -mapped devicesfor 1 

i VDP, GRGM, SOUND, and SPELCH 1 

I CPU nm at >83do I 

>AOQ0 f 

1 I 

f HI gfe Memo r y £ x p an s ion 1 

I Your program I 

I 1, 

>FFFr — + 



24.2.1.1 Expansion RAM 

M»"mtif3f E^pan^an unit is a 32K-byte peripheral on an eight-bit bus. It has two 
blocks of memory, an 8K block from >2000 through >3FFF and a 24K hinck from 
addresses >A000 through >FFFF. Addresses >FFD8 through >FFFF are used for XOP 1 
on the TI-99/4A. When your program is executing, the 24K block contains your 
pH^tam and the 8K bloc.k: '^ffls^ll^? .SfB Load^,. ptofe pa'i^f^aj^i <Sf Ct; 'l^^^ls^ii' ti^ 
fit in the 24K biock), utilities, and the REF/DEF table. 
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24.2.1.2 ROM 

AU t!w ROMs (Read Only Memory) ar& directly accessible by an assembly language 
program. Two 4K-byte consoie ROMs are located at addresses >0000 through >1FFF. 
They contain the operating system, the GPL interpreter, and part of the TI BASIC 
interpreter. 

The memory block at addresses >4000 through >5FFF is assigned to the peripheral 
ROMs which can be accessed by setting the bit assigned for the CRU (Communication 
Register Unit) to enable the particular ROM. These ROMs contain DSRs (Device 
Service Routines), and they are located in a peripheral. See Section 9 for more 
informBfciDn. 

Application ROMs are contained in command modules. They occupy address >6000 
through >7FfF- 

24.2.1.3 GROM 

A GROM (Graphics Read Only Memory) is another type of ROM. It is designed to 
contain GPL (Graphic Programming Language) programs which are executed by the 
CPL interpreter in the console. GPL is commonly used in applications software and 
can only be executed through a GROM, 

A GROM is a memory-mapped device, just as VDP RAM is. A GROM's memory is 
addressed by writing its address to a specific CPU address and reading data from 
another specified CPU address. See Section 16.5 for a discussion of accessing 
GROM 8. 

GROM addresses are from >0000 through >r7FF. Each GROM has 6K bytes of 
memory that start from an even-numbered first-digit address. For example, GROM 0 
la at addresses >0000 through >17FF and GROM 1 is at addresses >2000 through 
>5WTr, Hie fjompU^r ^aan m^m up ta OTOMs ^ a tore* 

GROMs 0, 1, and 2 are in the console and contain the monitor program, part of the 
operating system, and most of the TI BASIC interpreter. Five additional GROMS can 
be located in a Command Module. The number of GROMs used in a Command 
Mi«iti]le ciep^^ m tim size of the appUi^WiDns program. 
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24.2.2 Memory-Mapped Devices 

Synthesizer, the sound processor, GROMs, and so forth. VDP f^AM M discussed in 
this section. For discussions of other memory-mapped devices, Sections 16, 20, 
21, and 22. 

The Vided DiSfilif RAM, located tn Itlt consQle, h used chiefly for 

csmmon video functions, such as screen images, character pattern tables, color 
tables, etc. See Section 21 for a discussion of th& use of VDP RAM for 
screen-related functions. 

mmn 11 Bmw: la in use, VDP RAM also ertsitts the TI BASIC psQ^mffl^ the 
^afi®m ^^sifeetl %Hfe^. the value ai^ 1^ fcfeg space. VDP RAfS^ ii M» m^<i 

as a storage space by applications programs. Part of VDP RAM is used as a data 
buffer. Another part of VDP RAM functions as a PAB (Peripheral Access Block) to 
pass information from a file to the appropriate DSR (Device Service Routine). 
Asse;rw|l^ lijSitif p ^tnri'^^ fet executed frQm V^DP RAM, 

VDP RAM is a memory-mapped area of 16K (16,384 or >4000) bytes numbered >0000 
through >3FFF. VDP RAM addresses are automatically incremented, so only ohr 
address in CPU RAM is required to read or write a specific block of data. Assigned 
arfsfr.»eiB'. B'X^ sfflEEh" fiwilem Ix} thm: fy^'f^s, 0xa'n:i:ple:, VOP 'MM re^ad 
data Reglstei*' kj^td at €Ai MMM ^istUy tfm toP tmi mmm^ ^^^\wfm is 

found at CPU RAM address >8a02, the VDP write data Register is at CPU F<AM 
address >8C00, and the VDP write address Register is at CPU RAM address >8C02, 
See Section 16 for more information on writing to and reading from VDP RAM. 

m the next pagn: shov/S the memory af VDP RAM when it is bein^ used 
by the Editar/As^mbler. 
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VDP RAM Memory Use 
Ed it or / Asse mb ier 



>0Q00 +-«----^ - + 

I Screen Image Table [ 

I C>OT feyt«s) 1 

>0>00 

I Sprite Attribute List \ 

>D380 +--^---. -- + 

I Color Table I 

I and free space | 

>0400 + 

I Sprite Descxiptpr Table I 

I Sprite Motion table 1 

>0800 ---_—.._ + 

I pattern Generator Table I 

I Standard characters at >0900 through > AFF j 
I Also used for PABs | 

>1000 + 

1 Free memo r y s p a c e | 

j Also used for PABs and buffers j 

>57D7 +----^ ---- + 

I Blocks reserved for diskette DSR I 

>3FFF + + 
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243 MEMORY, GRU, A^M> INTERRUPT STRUCTURE 

The foilQwing gives the structure and addresses of the memory use in PAD at 
addresses >8300 through >83FF, C^U use, and if^^ra^ ftaniaiif. 



24.7.1 CPU RAM PAD Use 



CPU RAM PAD is located at addresses >&M through >83FF. The system software 
uses the high memory looations at addresses >83C0 through >B3FF. T*i€k Efii^ 0f the 
CPU RAM is used according to the type of routines being executed. The following 
diBscribes the use of this memory. 



Addresses Use 

>83D0 - >8349 Available for use fe^ ynuf ^Qgram, with some limitations. The 
system software useai tte sem onty fer temporary storage. 
However, if your assembly language program is executed through 
a TI BASIC program by CALL LOAD and CALL LINK, and the 
assembly language program returns control to Tl BASIC, only the 
area frim l^u^t^ ^t^^f is available. FurtheF, if 

parameters are passi^ Cj^LL then only the area from 

>8300 through >B30F is available. However, if TI BASIC is used 
only to load and transfer control to an assembly language 
program, all of this area is available to your program. 

>834A - >836D i^d m la mmiU ®*0a by the interpreter, floating pOi«t m^fmi:. 

and XW(^ routines. Unless console routines are called by your 
assembly language ^isgram, this area is available for use. 

>836E - >836F Available for your imM However, if the TI BASIC interpreter or 
floating point routines are running, this area is used as a value 
stack pointer. 

>S370 - >837F Used thB dPl. status httxik as follows. 

>8370 Contains the highest available address of VDP RAM. 

>837E The least-significant byte of the data stack pointer. The 

most-significant byte is >83. When the computer is initialized, 
this contains a value of >CF. However, after fhe ^sfc time It 
accessed, it is changed to >DQ. 
>8373 Tiiii least-significant byte of the subroutte iNfi^ pointer. The 

most-significant byte is >83. When the computer is initialized, 
this contains a value of >7E. However, after the first time it is 
accessed, it is changed to >80. 

number ^ m&f«:isnd, wllh m ^fault value of >0. 
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Addresses 

>8375 
>8376 
>8377 
>8378 
>8379 

>837A 



>837B 



>837C 



>B37D 



Use 

The ASCII key code detected by the scan routine* 
The Wired Remote Controller Y-location. 
The Wired Remote Controller X-location. 
The random number generator. 

The VDP interrupt tinner. It is incremented ^xtieth of 9 



It is originaUy set 



The number of sprites that can be in motion. 

to >Q0. 

The VDP status byte. It is a copy of the VDP status Register. 
Bit 0 is the 60 Hz VDP interrupt. It is on every time the screen 
1& i^^etd and Off ^s^itn the bit is read. 

Bit 1 is on any time there are five or more sprites on a line. 
Bit 2 is on any time that sprite coincidence occurs. 
Bits 3 through 7 contain the number of the fifth sprite on a line 
when there are five or more sprites on a line. 

The GPL STATUS byte. All the values are controlle^l ^ ttm GPL 
interpreter. 

Bit 0 is the high bit. 
Bit 1 is the greater than bit. 

Bit 2 is the condition bit. The key scan routine turns this bit on 

m t^ kv^mtB tat m file does not exist. 

Bit 3 is the carry bit. 
Bit 4 is the overflow bit. 

The character buffer used by the VDP. It reflects the code 
imM 1$m «eefi smsi of *ha TO* Loading a 

dtms^w?^ t^edb at Mb adidness results in dl^ls^i^ £be Gtumaf^te 
on the screen based on the pointers at address >857E and >837F'. 
Points to the current row on the screen. 
Points to the current column on the screen. 

The default subroutine stack address is >8380 and the default data 
stack address is ^8^A& Your assembly Isffi^jage^ pFQgram 'rm^ 
use this area unless it uses the GPLLNK routine. GPL uses 
subroutine stacks and data stacks while executing the routine* 
Thus, it is important to leave this area untouched. The TI 
BASIC interpreter uses address >838A through >83BF as the 
subroutine and data stack area, Additionil]^ ^M^sseS >8388 
and >8389 are reserved for t^ Tl SASIET WsM^i^ter, 
>83C0 - >83nF Interpreter Workspace. You must not use tWs area. The t^tes 
are used by the interpreter as follows. 



>837E 
>837F 
>8380 - >B3BF 
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Addresses 

>83C0 



>83C4 
>83CA 
>83CC 



>83DO 
>83D4 
>83D6 



>83D8 
>B3DA 
>83E0 - >83FF 



Use 

Random number seed. 

T14^#| isnly: Eight bytes for ireiBOte handset deMOMOJe and 
infeernal 

TI-99/4A only: Used as a flag byte to control interrupt routine, 
TI-99/4A only: Address of the user-defined interrupt routine. 
Console keyboard debounce. 
Bmrtd list pointer. 

Number of the sound byte, decremented on eaeh StDP irtterrupt. 
Sn^g^ p|^g|«l|or GROM and ROM search. Four bytes. 
Current value stored in VDP Register 1. 

Screen time-out counter, decremented on each VDP interrupt. 

Screen blanks after the word reaches >0000. Upon new key 

detectionj the word is reset. 

R©twn aefefep-^s SBved by th® :^n routine. 

Player number used by the scan routine. 

GPL Workspace Registers. This area is used as a register area 
by all the cpnsole routines, including the GPL and TI BASIC 
intertareters. iM& &t M f^giS^srs depends oh the routine 
executed- Hmmm». leisters 13, 14, ansf II s^%a mmBln the 
GROM write address, the system flags, aDd the VDP write 
address, respectively. 



24.3.2 CHU Allocation 

The Communication Register Unit (CRU) is used for system access to peripherals. 
There are 4K CRU bits, numbered >0000 through >OFFF, The CRU address loaded 
into Workspace Register 12 is twice the bit number. Thus, loading Workspace 
Register 12 with >IDOQ sets the base equal to CRU bit >B00, (See Section 9 for 
more informations) 0f the available 4K of CRU bits, the first K, at addresses >0000 
through >D7FE, are used internally by the console. This includes the TMS9901 I/O 
chip, which addresses the keyboard, joysticks, cassette, etc. See Section 24.3.3 for 
more information on I/O mapping. 

The secofKi K, at addre^es >Q8Q0 through >&FEi are reserved for future me* 

The last 2K, at addresses >1000 through >1FFE, are reserved for the peripherals that 
are attached to the console port, A hl(^k of 128 CRU bits is assigned to each 

peripheral m- Wi^s ili throtigh Ml mt- ^te lus lines. 
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Device 



CRU Addresses 


A3 


A4 


A5 


A6 


A7 


Use (peripheral) 


Number 


>OG0G 


- >£ffTE 


0 


i 














>1DFE 


I 




m 


u 


§■ 




0 


>110U 


- >11FE 


1 


0 


0 


0 


1 


Disk controUe? 


I 


->I/uU 


- >J,zrt. 


1 


0 


0 


1 


0 


Reserved 


2 


"S. 1 T API 


- >l^rE 


1 


0 


0 


1 


1 


RS232, ports 1 and 2 


3 




- >lArE 


1 


6 


1 




u 




4 






1 


G 


1 


Q 


I 


RS232, ports 1 and 4 


5 


s 1 nn 
>i6UU 


X 1 /'[_ L ' 

- >16rL 


1 


0 


1 


1 


0 


Reserved 


6 


\ 1 "7nn 
/I /UU 


X T "7i_ r" 


1 


0 


1 


1 


1 


Reserved 


7 


>IoUU 


- >iorL 


1 


1 


0 


0 


0 


Thermal Printer 


8 


>19Q0 


- >i9rE 


1 


1 


Q 


0 


1 


Future expansion 


9 


>1AOO 


- >1AFE 


i 


1 


0 


1 


Q 


Future expansion, 


10 


>1BOO 


- >ibfe: 


1 


1 


0 


1 


I 


Future expansion 


11 


>1C0D 


- >1CFE 


1 


1 


1 


0 


0 


Future expansion 


12 


>1D00 


- >1DFE 


1 


1 


1 


0 


1 


Future expansion 


13 


>lEaQ 


- >1EFE 


1 


1 


1 


1 


0 


Future expansion 


14 


>iroo 


- >|FFE 


.1 


1 


1 


a 


1 


P-Code peripheral 


15 



CRl_l arlclri^ss 0 at A8 through A14 is the memory enable bit in each device address 
space. Setting the bit to 1 turns the device ROM/RAM on, and resetting it to 0 
t^rtf tt &ffl "f^h- enables thf Ipdcte^S ffSm HOQO through reserved for 

the fseripheral ROM. 

24.3.3 Interrupt Handling 

The hlgh^^. |ji*ilaE^itji! ii^tsgMf^: ;are fehe raset and load vectors with a. pj-iQrilj^ 0, 
The reset interrupt is used when the computer is turne<J on. Intmro^^ fa^iiD^f 1 
connects through the TMS9901 Programmable Systems Interface for intempt 
expansion. The following shows the interrupts available. 
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9900 InterfUpts 



Interrupt 

L evel 

Highest 

0 

1 



Vector MemtX'y 

Address CMJ Pin 



>00QO 

>FFEC 

>D004 



RESET 
LOAD 

mri 



Assignment 

Reset 
Load 

external Device (TMS9901) 



Note that the lower priority CPU interrupts are rtot used. The following additional 
interrupts are impiemented on the TMS9901. 



9901 Interrupt Mapping 



Address 


CRU Bit 


9901 


Pin 


Function 


>0000 


0 


Control 




Control. 




1 


INTI 


17 


External. 


>0004 


2 


INT2 


10 


VDP vertical 










synchronization. 


>Q006 




INT3 


9 


Clock interrupt, keyboarc 










enter line, and joystick fi 










button. 


>Q008 


4 


INT4 


8 


Keyboard 1 line and 










joystick left. 


>QOOA 


5 


INT5 


7 


Keyboard p line and 










joystick right. 


>DdOC 


6 


INT6 


6 


Keyboard 0 line and 










IsS^tick dqwru 


>OQOE 


7 


INT7 (P15) 


34 


i%^JgWt$ i^ift line and 










joystick up. 


>0010 


8 


INT8 (P14) 


33 


Keyboard space line. 


>00I2 


9 


INT9 (P13) 


32 


Keyboard q line. 


>aoi4 


IQ 


mrm pm 




H^t»osp# 1 Ita. 


>QQ16 


11 


INTll (Pll) 


30 


Not used. 


>oaia 


12 


INT12 (PIO) 


29 


Reserved. 


>001A - >001E 


13 - 15 


INT13 - INT15 


28, 27, 23 


Not used. 


>0Q2Q 


16 


PO 


38 


Reserved. 




17 


PI. 


37 


Reserved, 




IB 


P2 


M 


»: % ^ y^^wA select. 




19 




n 


Bit I of feeyfeoard select. 
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Address 


CRU Bit 


9901 


>flOZ8 


20 


P4 


>uu2A 


21 


lie 


>0Q2C 


22 


P6 


>0Q2E 


23 


P7 (INT 15) 


>QQ3Q 


24 


P8 (INT14) 


>0032 


25 


PIO (INT12) 


>0036 


27 


Pll (INTll) 


>0038 - >003E 


28 - 31 


P12 - P15 



Pin Function 

tl ji # ^1^^?^^ select, 

20 Al^ha iock on the 

TI-99/4A. 

19 Cassette control 1. 

23 Cassette control 2. 

27 Audio gate. 

28 Magnetic tape output. 

30 ^aBgnetic tape mpiit. 

31 - 34 Not used. 
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2^^A CQMPARXSONS WITH TI EXTENDED BASIC LOADER 



The following seeUbns cojnpate the Loader that the Editor/Assembler uses with the 
Loaiiet us^ i^y TI EMtendecf BASIC, The rhSj'tip di.ffei^nC'^^ Invcjlve memor'y uSe, 
^$M^^: i^^E^^. rtfi^sstM^s, ^atility referencBs, entry points, diipUeate dstinitiOns, tagsj. 
mii use £jf ^me raatines. 



24,4*i Memory Usp 

One of the basic differences between the Editor/Assembler Loader and the TI 
Extended BASIC Loader is the use of the memory in the Memory Expansion unit. 

rm Ti mtended BASIC interprel^ tiS^lK^ ilgh memory location ^i^^i^ 
>A0OO for its own prefPim tM mimXBt m&' loadeci at the low^ 

memory area starting at address >2000, The Loader only recognizes the area 
between addresses >200D and >3FFF (size about 8K) as the area for an assembly 
language program. 

The E'iSt^£S3f/i'<wtt#i^ L^mdiST'^, tm^^vi^m bts^h ir«PSt» Iferfdpesses >2OQ0 

through >3FFF and >A000 through >FrD7), and the Loader is loaded at address >2000. 
The Loader checks the high memory area first. If there is not enough space left to 
load the program it is loaded into the low memory area. Thus, the Editor/Assembler 
Loader has more space (about 32K including utility routines and the Loader itself) for 
pisjjpgms than feh^ tl Mmm^'ed BASIC Loadm^* 

When using TI Extended BASIC, you can load the program in the high memory area 
by loading absolute code with a program which starts with an AORG statement. 
However, extreme caution must then be taken if the TI Extended BASIC program 
needs to run a^ter the ted lse©aMse tlia Tf Esefcetsited BASIC pdi^^nci code, line 
dtfriAiBr labie, and numepic values are located in the Kigh memory starting from the 
top af Eha memory* 

The easiest way to find out the available memory space in the high memory area is 
to do tsmmmm^ affe;et canning the TI Extended BASIC program -m^m^ Tim 

program space displayed on the ser^n i# &m jptce avsilatJie for the sssemEjIy 
language program. Note that tbis value i? giwert in decimai notafeisn. 

The other way to find the highest memory address available for assembly language 
programs is to execute the CALL PEEK statement at address >8386. For example, 
exi^ute CALL PEEni-JXM^p^M§ mn4 pnimi A mrrd B. This addi^ss contaim the 
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pointer to the highest free address in the expansion memory. Convert this value to a 
hexadecimal value, and compare It with the last address in the assembly l^^age 
program. 

It is possible for your assembly language program and the TI Extended BASIC 
program to overwrite each other if one or both of the programs use large amounts of 

The utility routines include a Name Lirtfc ^iRj^ne to search the program and other 
utility routines provided by the Loader, The basic memory configuration of both 
Loaders is similar, except that the Editor/ Assembler Loader has more utility routines 
mVaii^e and has free hlgh^ nfiemory spaces. 

The memory usage of the two Loaders is shown in the following figures. 



Memory Expansion Unit Use 
by the £ditQr/.^;&ssiTibler Loader 

>2000 + - + 

I ID code >A55A | 

>2002 + + 

I XM- vectors used by Ed i tor /Ass emb 1 er t 

>OT22 

I UTLTW irtiMt^ ^«ta area I 
>21Q0 + ----+ 

I Ut i i 1 1 y BL^ veo 1 0 r s | 
>2128 + + 

I Ut i 1 i ty rout ines | 

I Assembly language program area f 

I I 

>3F38 + + 

I REF/DEF table | 
y 3FFF -* w *■ rf-,*.-,--*.-.-*--^-^.-^-.^, 

>AOO0 # + 

I I 

I Assembly language program area 1 

I 

>FFEO . . . + 
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Memory Expansion Unit Use 
by the TI Extended BASIC Loader 

>ZQ£»3 + + 

I XML vector used by the interpreter I 

>2002 + -+ 

I Ut i I i ty data area 1 

>20Q6 + - - + 

I ID code >AA55 \ 

>2D08 +-- - + 

1 Ut i 1 i ty BLWP vectors I 
+ .+ 

1 Ut i 1 i ty r ou 1 1 nmis I 
+ ' + 

I I 
I Assembly language program area j 

+ - + 

1 DEF table 1 
>3FFr + - + 



>A000 - 

I Free spane, end pointed tO by I 
I CPU RAM address >83a6 t 
+ -. + 

I Numeric Values I 

+ - + 

I Line number table I 

+ 

I TI Extended BASIC program space | 
>FFEO + + 



24.4.1 Loailing Speed 

Both Loaders are tagged object loaders which load a fixed 80 display format file from 
a diskette. The difference between the Loaders is the greater speed of the 
Editor/Assembler Loader. Also, it handles compressed object files, which the TI 
Extended BASIC Loader cannot handle. 
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Zh^,J External Ref erenieefli 

The Editor/Assembler Loader is a linking loader which handles external references. 
Tfs^ St program can be broken into different ^Ie% ^n^d section of the: ^^ram 
can be referred ^ to iy means # and DEF iratructions. The TI 

Extended BASIC Loader cto^s not allow external references. 

For example, if both the following programs are loaded and run, the Editor/Assembler 
resolves all referanjces* 

€»• DATAl.PRGM 

* 

DATAl EQU >1234 
* 

PRGM ... Beginning of the program. 



END 



DEF MAIN 

REF DATA1,PRGM,KSGAN 

* 

MAIN ... Beginning of the program. 



LI R1,DATA1 



BL ©PRGM 



END 
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24.4.4 Utility References 

The TI Extended BASIC Loader only handles DEF statements and DEFed labels that 
are entered by the Loader as it loads the program. In order to access the utility 
routines in TI Extended BASIC, equated addresses must be specified in the program 
by £CiU initeii^orfs. ice iesMort M^MJB d^it'^W^ W tM ^j^SM iiii^ssef* 

The Editor/ Assembler Loader creates pre-defined labels of all the utility routines and 

frequently accessed memory addresses. Thus, REF instructions in your program are 
sufficient to access the utility routines, and object tags 3 and 4 are accepted by this 
Loader, 



24.4.3 Entry Point 

Another feature of the Editor/Assembler Loader is that it allows a program entry 
point to he specified with the END instructions. Any address label with the END 
statfi^ent Is SJin^teed to be the address mnd executes the program ifrtme^a^yi 
without comming back to the Edit or/ Assembler screen. Thus, object tags 1 and 2 are 
accepted by this Loader. 



24.4.6 Duplicate Definition 

Duplicate definition is allowed by the TI Extended BASIC Loader, with the Loader 
replacing the new defintion with the old definition. Thus, if two programs with the 
same entry name are loaded, the most recently loaded program is executed when the 
name is specified. 

The Editor/Assennbler Loader, however, issues a DUPLICATE DEFINITION error 
message, and loading stops. 



24^*7 Tags 



The comparison of the object tags is listed on the next page. 
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Tans 

1 a u w 

n 


PiinpUnn 


Fxtendpd RASIC 1 nadpr 

ilr^rt rt I* t" tfrl 


Pdifnr/As'ipmhlpr 1 nadpr 






TniirtrpH 


Stitsnorted 




(— vhofn^l 1^ 1— c 
L_ X teri Idl r\Cr b 


issues error 


aupporteu 


S ^ 

-P, D 


I — A L d J IcLl L^l i O 




Qi l^lonp^fi^l 

OULJLjUi LOU 


/ , 0 




oupporteu 


Supported 




)! — uavj ctuuicou 




Inn nr horl 


R P 
Dj 




OU pp OF kBU 


3upp[3r bSU 


D., E 


Load bias 


Issues error 


Issues ercor 


F 


End of record 


Supported 


Supported 


G, H 


Unused 


Issues error 


Issues error 


1 


Program ID 


Ignored 


Ignored 


M 


Data/common se^u 


Iporecl 


Issues erfpr 


Other 




lasues error 


issues error 



In order to access the utility routines of the TI Extended BASIC Loader, all the 
utility references must be done by equating (with EQU) to the routine address. 

24.4.8 TI E^ctend^ BASIC Equates 

The following shows the equates used in Tl Extended BASIC, 



VDPWA 


EQU 


>8C02 


VDPWD 


EQU 


>BCOO 


VDPRD 


EQU 


>8flD0 


vopsm 


mxj 


>mMt 


FAC 


EQU 


>834A 


GPLWS 


EQU 


>83E0 


PAD 


EQU 


>8300 


SOUND 


EQU 


>8400 


SPCHRD 


EQU 


>9QDQ 


SPCMWT 


EQU 


>94D0 


GRMRD 


EQU 


>mm 


GRMRD 


EQU 


>9802 


GRMWD 


EQU 


>9C00 


GRMWA 


EQU 


>9C02 




eau 


>0OOE 



* UMUt^ Branches- 
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NUMASG EQU >20Ql 

NUMREF mu >2Dl3d 

STRASG EQU >2010 

5TRREF EQU >2014 

XMLLNK EQU >2018 

KSCAN EQU >201C 

VMBW EQU >aa24 

VSBR EQU >2028 

VMBR EQU >202C 

VWTR EQU >2030 

Em EaU >:2a34 

FSUB EQU >0D7C 

FMUL EQU >0E88 

FDIV EQU >0FF4 

sAm mu >mm 

ssuB EQU mm^ 

5MU1. EQU >OEBC 

SDIV EQU >UFr8 

CSN EQU >11AE 

CFI mil >12B8 

FCOMP EQU >DD3A 

NEXT EQU >0070 

COMPCT EQU >QQ 

GETSTR EQU >02 

MEMCHK EQU mi 

cm EQU >Q6 

VPUSH EQU ICE 

VPOP EQU >10 

ASSGNV EQU >18 

EQU >20 

¥WOT; Mi' >34 

GVWITE EQU >:3i5 
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t 


J^meade Oversow, 


ERRSYN 


EQU 


>0300 


3 


Syntax Error. 


ERRIBS 


EQU 


>Q4QQ 




Illegal After Subprogram. 


ERRNQS 


EQU 


>0500 


5 


Unmatched Quotes. 


ERRMTL 


EQU 


>0600 


6 


ffe^ftff Too Long. 


ERRSNM 


EQU 


>0700 


7 


String-Number Mismatch. 


ERRd« 


EQU 


>080D 


8 


Option Base Error. 


ERRMUV 


EQU 


>0900 


9 


Improperly Used Name. 


ERRIM 


EQU 


>0A00 


10 


Image Error. 


ERRMEM EQU 


>Q6QQ 


11 


Memory Full. 


mR» 


mu 


>acoo 


12 


Stack Overflow. 


ERRNWF 


EQU 


>0D00 


13 


NEXT Without FOR. 


ERRFNN 


EQU 


>0E00 


14 


FOR-NEXT Nesting. 


ERRSN5 


EQU 


>0FOO 


15 


Must Be in Subprogram. 


ERRRSC 


EQU 


>1000 


16 


Recursive Subprogram Call. 




&m 




17 






mu 


>mm 


13 


WrURN Without GOSUB. 


ERRST 


EQU 


>1300 


19 


String Truncated- 


e:rrrbs 


EQU 


>1400 


20 


Bad Subscript. 


ERRSSL 


EQU 


>1500 


21 


Speech String Too Long. 


ERRLNF 


EQU 


>16Q0 


m 


Line Not Found. 


ERRBLN 


EQU 


>1700 


23 


Bad Line Number. 


ERRLTL 


EQU 


>1800 


24 


1 ine Too Long. 


ERRCC 


EQU 


>1900 


25 


Can't Continue. 


ERRCIP 


EQU 


>1A00 


26 


Command Illegal in Program, 


ERROLP 


EQU 


>iBOO 


27 


Only Legal in a Program. 


ERRBA 


EQU 


>1C0Q 


28 


Bad ^^iM^ument. 


ERRNPP 


EQU 


>1D0Q 


29 


No Program Present. 


ERRBV 


EQU 


>1E00 


30 


Bad Value. 


ERRIAL 


EQU 


>iFoa 


31 


Incorrect Argument List. 


ERRINP 


EQU 


>2000 


32 


Input Error. 


ERRDAT 


EQU 




33 


Data Error. 


ERRFBT 


mu 


>mm 




Filer EaiFor. 


ERRIO 


EQU 


>2400 


36 


I/O Error. 


ERRSNF 


EQU 


>250a 


37 


Subprogram Not Found, 


ERRPV 


EQU 


>2700 


39 


Protection Violation. 


EmrvN 




>2800 


m 


Unrecognized Character. 




EQU 


>^0O 


41 


Numeric Overflow. 
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WRNST EQU >2A0O 

WRNNPP EQu >mm 

WRNIHP EQU >2C00 

WRNIO EQU >2D0Q 



42 String Truncated. 

^0 No Program Present, 

44 Eftput Errcjr- 

45 I/O Error. 



24.4.9 Subprogram Use 

All the TI ^i^J^ interface and m^m% m^l^rm kf to Tl Enmti^t^ MSIC Loader 
are supported by the Editor/Assembler Loader. However, some routines work slightly 
differently. The use of these subprograms with TI BASIC when the Editor/ Assembler 
module is attached is described in Section 17. The following describe how they differ 
from the T| Es^errdie^ M^C ^t^r^ wtt ^10 same r^m^ 

CALL INIT— Loads the utility routines from a TI Extended BASIC program or from 
the Editor/Assembler command module. This subprogram functions similarly, but the 
code that accomplishes it is different. 

CALL LOAD— The Editor/Assembler is forced to load the utility routines if they have 
mt b^rt lt^^#d % l^lt routine. This is not done in the TI Extended BASIC Loader, 
and an an error Is issufed if INIT has not been called. 

CALL LINK— The Edit or /Assembler Loader uses its own workspace to store 
information from the parameter list. Only the addresses >8?10 through >a312 are 
reserv&d for parameter ^^^s^^ purposes. TI E>c£mled SiASId wmn addresses >8300 
through >8315 for this information. Your assembly language program must not 
modify this area if parameters are to be accessed in the program. 

CALL PEEK— The Editor/ Assemhler allows the TI BASIC program to p0k mor^ than 
:mm- nmsmmim fnemory area itr a ^^JSKEe^ftf tmm^ n (mil 
whereas TI Extended BASIC only allows one consecutive memory area to be peeked in 
each statement. 

l^^i ©^l* ^«^--*The3B am not ft Extended BASIC, 

ERROR LINK ROUTINE— The error code used with the TI Esteftdi^ BASIC suppcwt 
routine may not give the same error message when the program is run in the 
Editor/ Assembler environment, due to the fact that the TI BASIC and TI Extended 
MSIC: i^erpreters Mre ^ff^te^ &p^m meiSN^w and error hamlBng roul^es. 
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Note also that the error messages ^vin by the Edit or/ Assembler while executing TI 

Interface routines use Bm censoJe TI SiW3G mror messages. They are very 
often dittifrent from the error message issued hf Tt E^^mlM For example, 

the STRING-NUMBER MISMATCH error issured by TI Extended BASIC is a SYNTAX 
ERROR when issued by the Editor/Assembler since the TI BASIC in the console does 
not contain the STRING-NUMBER MISMATCH error message. 

The TI Extended BASIC sc^^pM routines which mm G&ed to access numeric and string 
pSiran^Ml^ Kr6 slightly modified in the ^t&;s^f^$smiW&t vision in .toM^ W iJtllite 
eeaiSit ^taanes in the console TI BASIC ir^^^Jgeter. However, assembly language 
programs access them exactly the same way as with the TI Extended BASIC utilities. 
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24.5 SAVE UTILITY 

The SAVE utility mlmm fm W ms^9 %BEgfed ofaject code in memory image 

format on either diskette or cassette. In this format prograrm em% tre run by using 
the RUN PROGRAM FILE option on the Edit or/ Assembler. 

The SAVE program is on the Edit or/ Assembler dinette labeled Part B under the name 
SAVE. The :^^^am is executed ifdth the LOAD AND RUN opUon on ^ 



Edltir/^MlS%li^ Hgpever, before It is run, you must include certain DEFs in your 

program, assemble it, and load it- 

Your program must contain DEF SFIRST,SLAST,SLOAD, with these symbols defined as 

SFIRST must be a pointer to the start of your program. Further, the start of the 
program must be an executable instruction. However, SFIRST does not 
necessarily reflect where the memory image program is loaded, 

SLOAD must be the address whem M 9S^ed prograin U ^ ta^MU Since 
memory image programs are not relocatable, SLOAD should uau^Uy equal SFIRST, 

SLAST must be a pointer to the address after the last word of your program. 
This can be done most easily by making SLAST the label for the END directive In 
your program. 

Then choose the LOAD AND RUN option. For the first file name, enter the name of 
your object file: for example, DSKl.OBJECT. Then enter the name of the SAVE 
program, DP<X*Mfc tt» press <retiirff> to go to next prompt, and mte^ 
p^Q0mm. mmm m SME. The utility then executes. It displays reminders 

about using t^e utility and prompts for a file name for the file that it creates. 

To output to cassette rather than diskette, enter the file name CSl. 

Jfm uHtUf 'tsm. <sr^y save SK m em fUB* If ywr^ j^Qpgrs is larger than that 
(SFIRST minus SLAST is greater than >2000 bytes), then the SAVE utility creates a 
second file by incrementing the last byte of the current file name, thus creating a 
new file name. The Edit or /Assembler option RUN PROGRAM FILE expects files to 
be linked in this way. 
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If you save a file on CSl that is larger than 8K, do not rewind the cassette 
when savlt^ sttftofral files, evm tftiSi^H y^u are instructed to do so. Otherwise 
you will save the additional files over the first one. When loading programs that 
consist of more than one file using the RUN PROGRAM FILE option, give the input 
file name as CSl. If you give it as CSl, then the RUN PROGRAM FILE option 

iM^ment the name to CS2 for the second file, and CS2 is an invalid file name 
in RUN PROGRAM HLE. 
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24.6 SPEECH SYNTHESIZER RESIDENT VOCABULARY 

Tfm lowing U m M @l M mti^N^ «^ ^m^: Wim "mi' bei 

accessed, followed by the location df thBtr ccidds iri ROM. See Section 22 far a 
description of the use of speech. 



Phrase 

- (NEGATIVE) 

, (POINT) 

1 

3 

5 

7 

9 



48DC 
50EC 
1409 

mA 

1531 
15E8 
1664 



Phrase 

+ (POSITIVE) 

0 

2 



Addre^ 

51B3 
13C3 
145C 

imi 

15A8 
1637 



A (ay) 

ABOUT 

AGAIN 

AM 

AND 

ANY 

AS 

AT 



16E4 



17A5 

1830 

18AC 

1962 

19A7 

1A25 



Ai (uh) 

mm 



AN 

ANSWER 

ARE 

ASSUME 



1700 



1876 
1913 
556E 
19E8 



B 

BASE 



BLUE 
BOTTOM 
BUY 
BYE 



1A42 

lASr 

lADE 

1B8A 

IBEA 

1C48 

1C48 



BACK 
BE 

BLACK 
BOTH 
BUT 
BY 



1A64 
aA42 



1BB6 
1C20 
1C48 



C 

CASSETTE 

CHECK 

CLEAR 

COME 

COMMA 

COMPLETE 

COMPUTER 



IDIO 

1D82 

1DE6 

1E54 

lEDE 

lF7a 

2034 



CAN 

CENTER 

CHOICE 

COLOR 

COMES 

COMMAND 



CONNECTED 



1CD9 
1D47 

1DA2 
1E20 
1E87 
IFIA 

3Fm 

2QSB 
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Phrase 
ODNSOLE 



D 

DECIDE 
DID 

DISKETTE 

DOES 
DONE 
DOWN 
DRAWING 



Address 

20F3 

2182 



22Q3 

2294 

2366 

242D 

24B3 

253E 

25D3 

2668 



Phrase 

CX)RRECT 

CYAN 

DATA 

DEVICE 

DIFFERENT 

DO 

DOING 

DOUBLE 

DRAW 



Address 
2X3C 

aco 



2230 

22rD 

23C4 

2480 

24EA 

2599 

2612 



E 

EIGHT 

ELEVEN 

END 

ENTER 

EXACTLY 



26CB 

1637 

2759 

27F5 

28AD 

2937 



EACH 

EIGHTY 

ELSE 

ENDS 

ERROR 

EYE 



26F0 
2723 
27B6 
2866 



3793 



F 

FIFTY 

FIND 

FINISH 

FIRST 

FIVE 

FORTY 

FOURTEEN 

FROM 



299F 

2A1D 

2AD7 

2B5B 

2BD7 

1531 

2C3E 

2C7F 

2D74 



FIFTEEN 

FIGURE 

HNE 

FINISHED 

FIT 

FOR 

FOUR 

FOURTH 

FRONT 



29C2 
2A6Q 
2B1E 
2B94 
2014 
14E7 
14E7 
2D19 
2DBC 



G 

GET 



GOING 
GOOD WORK 
GOT 
GREEN 



2DEB 

2E8C 

2F38 

2FFC 

3079 

30FA 

31A0 

321D 



GAMES 
GETTING 




GOOD 
GOODBYE 
GRAY 
IXIESS 



2E28 

2EBA 

2F8D 

3031 

30D6 

3148 

31D1 

327E 



H 

HAND 



32C0 
3339 



HAD 32EF 
HANDHELD UNIT 337F 
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Phrase 

HAS 

HEAD 

HELLO 

HERE 

HIT 

HOW 

HUFIRY 



Address 

3405 

348C 

351A 

34E5 

360A 

3^9 

5757 



Phrase 
HAVE 
HEAR 
HELP 

HIGhlER 

HOME 

HUNDRED 



Address 
344A 

34E5 

3571 

35AE 

363E 

36EF 



I 3793 

r 3850 

INCH Mm3 

INSTRUCTION 394B 

IS 3A32 



1 WIN 57CF 

IN 3872 

II^C^ 38FA 

INSTRUCTIONS 39BD 

IT 3A7A 



3UST 



3AAE 
3B4C 



■JOYSTICK 



3AED 



K 

KEYBOARD 



3BBA 
3BE9 



KEY 
KNOW 



3BB9 
3C4F 



LAST 

LEFT 

LET 

LIKES 

LOAD 



LOWER 



3C8F 
3D19 
3DDE 
3E7a 

3ro8 

3F6A 
404B 
413D 
41E7 



LARGE 

LARQI^T 

LEARN 

LESS 

LIKE 

LINE 



LOOKS 



3CD0 

3067 

3E1E 

3EB2 

3F2F 

3FD5 

40D3 

4191 



M 

MAGENTA 



4233 



MEMORY 

MESSAGES 

MIGHT 

MORE 

MOVE 



4405 

44D7 

4593 

4^42 

46DF 



MADE 
MAKE 



MESSAGE 

MIDDLE 

MODULE 

MOST 

MUST 



4267 
4>2E 



446C 

4551 

45DF 



473D 
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Phrase 
N 

NEAR 
NEGATIVE 
NICE TRY 
NINETY 
NOT 

NUMBER 



Address 
4786 

4833 

48 DC 

49A5 

4A4E 

4AAB 

4B20 



Phrase 

NAME 

NEED 

NEXT 

NINE 

NO 

NOW 



Address 

47CT 

4B8Q 

4959 
1664 
3C4F 
4ADA 



0 

OFT 
ON 

ORDER 
OUT 



4B7D 
4Ci3 
4€» 



4D34 
4DD4 



OF 
OH 

am 

OR 

OTHER 
OVER 



4BBA 

4B7D 

1409 

4CDC 

4D8A 

4E0A 



PARTNER 
PERIOD 

PLAYS 
POINT 
POSITIVE 



PROBLEM 

PROGRAM 

PUTTING 



4E66 

4EE0 

4FBI 

502D 

50EC 

51B3 

526D 

52r9 

53EE 

54AA 



PART 

PARTS 

PUV¥ 

PLEASE 

POSITION 

PRESS 

PRINTER 

PROBLEMS 

PUT 



4E9F 
4^31 
4FE5 

5093 
5148 
5231 



5360 
5477 



Q 



5520 



R 556E 
READ Creed) 5652 
READY TO START 56B3 

S7C1 



REWIND 
ROUND 



593A 
59C2 



RANDOMLY 

READl (red) 

RECORDER 

REFER 

RETURN 

RIGHT 



55A0 

57C1 

5745 

5801 

58CF 

7C38 



SAYS 

SECOND 



5A5A 
5AEF 
5BA2 
5C5B 



SAID 
SAY 

SCREEN 
SEE 



5AA1 
5B65 
fiFB 
1C86 
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Phrase 


Muuress 


rnrase 


rtuuress 




>L.t5r 


X. I 






icc-o 


ot.vti.iN 1 r 


snsn 


bHAPt- 


jUAj 


oMMr't.D 




r* LJTr — r 
brilr 1 


Jt-i / 


Cl-IOR T 








ci_ini )i n 


SF9A 


SIUE 


5roU 






SIX 


1 C A O 

15 Ao 


SlI^I Y 


am & 
oUlA 


bMALL 


oU/U 


C kA Al 1 C" O 


OUAt, 


C K / A ( 1 CCT 


oUr 1 


cn 
bU 




SOME 


6197 


SURRY 


6iL.6 


SPACE 






^> 


SPELL 




SQUARE 


6333 


b 1 AK 1 




CTCD 




a 1 UP 


oJr / 




DX7 / 


CI IQCDi~lCC"n\ 

bUMKUbt-L/ 




CI IDDOCCr* TO 




Cl IPC 








T 
1 




1 rVINC. 




Th.E.N 




TCI 1 


OoU J 


I LN 


Z Z A C" 

o64t. 


T[rV/\C TN.ICTOI IKvlirMXC 




Tl 1 A d. 1 

THAN 


67 5d 


T(_l A "T" 

1 HA 1 


67do 


THAT IS INCORRECT 


mXo 


THAT 11 RIBHT 


«8FE 


THE (thee; 


6974 






THEIR 


6A7Z 


THEN 


69E1 


THERE 


6A7Z 


I MtbL 


oAUt. 


1 rit. Y 




1 riiiNUi 


(CR An 


TuJTKi nc 
i rliiNLia 


Ol-Ur 














TMTR TV 
1 111 r\ 1 T 


ADA? 


TMTC 




\ r1rs.t_L 


1 /iQ A 


1 nrxcw 




TLJOf"!! I(~*l 1 


oEZo 


TT KAC 

1 1 Mb. 


Ot.07 


TO 




TOGETHER 


6EB0 


TONE 


fiPlF 


TOO 


im^ 


TOP 


6F8D 


TRY 


6FBB 


TRY AGAIN 


700F 


TURN 


7092 


TWELVE 


70CE 


TWENTY 


7119 




145C 


TYPE 


7170 
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Phrase Address Phrase Address 

U 7aBE UHOH 71F4 

UNDER UNDERSTAND 729D 

UNTIL 732F UP 739F 

UPPER 73C3 USE 7403 

V Wm WRV 7AB7 
VERY 74DA 

W 7520 WAIT 759D 

WANT 75DF WANTS 7621 

WAY 76B0 m. 7€7D 

WEMH 76B0 WEIGHT 759D 

WELL 7717 WERE 775C 

WHAT 77BC WHAT WAS THAT 77E9 

WHEN 7875 WHERE 7aAB 

WHICH 78F4 WHITE 7924 

WHIO 7969 WHY 7984 

mtL mil WITH IMB 

WON 1409 WORD 7AAB 

WORDS 7B0A WORK 7B75 

WORKING 7BBC WRITE 7C38 

X 7C8D 

Y 7CB2 YELLOW 7CF8 
YES 7D58 YET 7D99 
YOU 71BE YOU WIN 7 DO0 
YOUR 7E4D 

Z 7E99 ZERO 13C3 



EmrOR/ASSEMBLER 

Page 427 



24.7 CHARACTER SET 

^IwMssennbler recognizes the ASCII Et^»^T» l^i^ Eft iMminq ^tJle. 
The table includes the ASCII code for each character represented as both a 
hexadecimal and decinnal value. The Editor/Assembler also recognizes the six special 
characters shown in the second table. On the T1-99/4A Honne Computer, the 
Editor/ Assembler also represents the lower-case letters, 1, }, and the tilde 9® ^iM^Sffi tn 
the third table. 



Editor/ Assembler Primary Character Set 



Hexadeci^f^ 



Decimal 
Value 



Space 




32 
>3 
34 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 



0 
1 
2 
3 
4 
5 
6 
7 
6 
9 



I 

% 

& 



tl 



/ 
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Hexadeeimial D^Jimai 

Value Value CharaGter 

3B 59 s 

3C 60 < 

3D 61 = 

m m > 

3F 63 ? 

40 64 1 

41 65 A 

42 66 B 

43 67 C 

44 63 D 

45 69 E 

46 70 F 

47 71 G 

48 72 H 

49 . 73 I 
4A 74 J 
4B 75 K 
4C 76 L 
4D 77 M 
4E 78 N 
4F 79 O 

50 80 P 

51 81 Q 

52 82 R 

53 83 S 

54 84 T 

55 85 U 

56 86 V 

57 87 W 

58 88 X 

59 89 Y 
5A 90 Z 
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^dittat/Assembier Special Ghai^cters 



Hexadecimal 


Decimal 




Value 


Value 


Character 


$m 


91 


[ 


5C 


92 


\ 


5D 


93 


] 


5E 


94 


* 


5F 


95 




60 


96 




TI-99/4A Editor/ Assembler Additional Characters 


Hexadecimal 


Decimal 




Value 


Value 


Character 


61 


97 


a 


62 


9B 


b 


63 


99 


0 


64 


100 


d 




101 


e 




102 


f 


o / 


im 
lUJ 




68 


104 


h 


69 


105 


1 


6A 


106 


J 


6B 


107 


k 


6C 


108 


1 


6D 


109 


m 


6E 


110 


n 


6F 


111 


0 


70 


112 


P 




113 


q 


11 


114 


r 


73 


115 


s 


74 


116 


t 




117 


u 


76; 


118 


V 


77 


119 


w 


78 


120 


X 


79 


121 


y 
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Hexadecimal Decimal 

Value Vafeps -C^ji^i^lei 

7A 122 z 

7B 123 { 

7D 125 } 

7E 126 



24.8 ASSEMBLER DIRECTIVE TABLE 



The assembler directives for the TI Home Computer are listed in the following table. 
All directives may include a comment field following the operand field. Those 
directives that do not require an operand field may have a comment field following 
the operator field. Those directives that have optional operand fields (RORG and 
END) may have conriment fields only when they have operand fields. 

The following symbols and conventions ar© uised in defining the syntax of assembi^r 
directives. 




An ellipsis (...) indicates that the preceding item may be repeated. 
Braces ([ }) enclose two or more items of which one must be chosen. 



label A symbol used in the label field. 

string A character string of a length defined for each directive. 

expr An expression. 

wi BXpr A well-defined expression*. 

Wtee* The term ysed to ref er to ah extended operation, 

operation A mnemonic operation code, macro name, or previously defined 
operation ox extended operation. 



Assembler pirgpUves 




Directive 
TiTLe 

IDTntifier 
External DEFinition 
External REFerence 
COPY file 

RelQcatable ORIGifi 
OiiiTtmy C3R,i0in 



Syntax 

i:<iafael^] TITL €string> 
[<label>] IDT 

[<label>] DEF <symbQl>[,<symbol>]... 
[<label>] REF <symbol>[,<symbDi>]... 
[<label>] COPY "<file name>" 
[<l^eJ>3 AORG <wd ©xpr> 
[<label>] BORqt [<expr>] 
[<label>] DORG [<expr>] 



Force 
Word 

Boundary Note 



NA 
NA 
NA 

mq a 

■No 
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Force 








Word 




Directive 


Syntax 


Boundary 


Note 


Block Starting 


[<label>] BSS <wd expr> 


No 




with Symbol 








BWts^t Ending 








Initialize word 


[<label>] DATA <expr>[,<expr>],.. 


Yes 




Initialize TEXT 


[<label>] TEXT [-] <string> 


No 


1 


Define extended 


[<label>] DXOP <symbol>, <term> 


NA 




operation 








Define assembly- 


[<label>3 EQU <Gxpr> 


NA 


2 


time constant 








Word boundary 


[<labei>] EVEN 


Yes 




No source List 


[<iabel>] UNL 


NA 




LI ST Si^upBie 


[<labei>] LIST 


NA 




PAGE eject 


[<label>] PAGE 


NA 




Initialize BYTE 


[<label>] BYTE <wd expr>[,<wd expr>]... 


No 




Program END 


C<label>] END [<symbol>] 


NA 


3 


Program SEGment 


[<labei>] P5EG 


Yes 


4 


Program segment END 


[<label>] PEND 


Yes 




Data SEGment 


[<label>3 DSEG 


Yes 


4 


Data segment END 


[<label>] DEND 


Yes 


4 


Common SEGment 


[<label>] CSEG [<string>3 


Yes 


4 


Common segment END 


[<label>] CEND 


Yes 


4 


Secondary REIFerence 


[<label>] SREF <symbol>[,<symbol>3... 


NA 


4 


Foree LOAD 


[<label>3 LOAD <symbol>[,<symbol>]... 


NA 


4 



Notess 



The minus sign causes the Assembler to negate the right-most character. 
Symbols in expressions rmnt have been previously defined. 
Symbol mu^ have been previously i^^rted. 

These directives have no effect when using the Loader provided with the 
Editor/ Assembler. 
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24.9 HEXADECIMAL INSTRUCTIOM TABLE 

The following table lists the TMS9900 assembly language instructions, their fornnat, 
and the section in which they are described. They are in order according to their 
hexadecimal operation code. For an alphabetical listing by their mnemomic operaUon 
tm. m.Xn* ^ mmm 5 feir an expIar^^iStt igf format. 



Hexadecimal 


Mnemonic 








Operation 


Operation 








Code 


Code 


Name 


Format 


Section 


0200 


LI 


Load Immietdiate 


Via 


10.1 


0220 


AI 


Add I mmediate 


VIII 


6.4 




ANDI 


AND Immediate 


VIII 


11.1 


Q26Q 


ORI 


OR Immediate 


VIII 


11.2 




CI 


Comoare Immediate 


VIII 


8.3 


02A0 


STWP 


ST ore Workspace Pointer 


viii 


10.7 




STST 




VIII 


10.6 


02ED 


LWPI 


Load Workspace Pointer 


VIII 


10.3 






Immediate 






0300 


LIMI 


Load Interrupt Mask 


vni 


10.2 




IDL£ 


IDLE 


vn 






RSET 


ReSET 


VII 


9.6 


0*580 


RTWP 


ReTurn with Worksoace 


VII 


7.17 






Pointer 






03A0 




CJtiGt< ON 


VII 


9.6 






OeeK £3Ff 


vn 




03E0 


LREX 


Load or REstart eXecution 


VII 


9.6 


0400 


BLWP 


Branch And Load Workspace 


VI 


7.3 






Pointer 






0440 


B 


Branch 




IS 


0400 


X 


EXecwte 


VI 


7.18 


mm 


CLR 


CLI^ operand 


¥1 


llj 


Q500 


NEC 


NEGate 


VI 


6.11 


□540 


INV 


INVert 


VI 


11.4 


□580 


INC 


INCrement 


VI 


6.8 




mcr 


IfC^-ement by Two 


VI 


^.9 


0600 


DEC 


DECremeiiA 


VI 


B.% 


□640 


DECT 


DECrement by Two 


VI 


6.6 


0680 


BL 


Branch and Link 


VI 


7.2 
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Hexadecimal 


Mnemonic 








Operation 


Operation 








Code 


Code 


Name 


Format 


Seetioji 


men 


SWPB 


SWaP Bytes 


VI 


lOJ 


0700 


SETO 


SET to One 


VI 


11.6 


0740 


ABS 


ABSolute value 


VI 


6*> 


0800 




Sliift Right Arithmetic 


V 


12-1 


IM3 




Shifl Right Logical: 


V 


12.2 




SLA 


nun Mmm&t\c 


V 


12.J 


OBOO 


SRC 


Shift Right Circular 


V 


12,4 


1000 


JMP 


Unconditional JuMP 


ri 


7.11 


1100 


^LT 


Jump Less Than 


II 


7,10 


1200 




Jump if Low Or Equal 


n 


7,$ 


1>0D 


JEQ 


Jump EQual 


II 


7.4 


1400 


3HE 


Jump High Or Equal 


II 


7.6 


1500 


JGT 


Jump Greater Than 


n 


7.5 


1600 


ONE 


Jump Not Equal 


II 


7.13 


1700 


JNC 


Jump No Carry 


n 


7.12 




aoc 


Jump Wm t^my 


n 


74,6 






Jump No Overflow 


n 


IM 


lAOO 


JL 


Jump if logical Low 


II 


7,8 


IBOO 


JH 


Jump if logical High 


II 


7.7 


ICOO 


JOP 


Jump Odd Parity 


n 


7,15 


10GO 


SBO 


let I^U 'Bft to One 


n 


%M 


lEOO 


SBZ 


Set CRU Bit to Zero 


II 


9.3 


iroo 


TB 


Test Bit 


II 


9.5 


2000 


COC 


Compare Ones Corresponding 


III 


8.4 


2400 


CZC 


Compare Zeros Corresponding 


in 


8.5 


2800 




Exclusive OR 


in 


11.3 


2C00 


XOP 


Extended Operation 


IX 


7.19 


3000 


LDCR 


LoaD CRU 


IV 


9.1 


3400 


STCR 


STore CRU 


IV 


9.4 


3800 


MPY 


MultiPlY 


IX 


6.10 


3C00 


DIV 


Divide 


fx 


6.7 


4000 




Set. 'Zbpos 


I 


11.9 


5Q0Q 




Set Zeros Gorraspondlhg) 
Byte 


I 


11-lP 


6000 


S 


Subtract words 


I , 


6.12 


7000 
8O0Q 


SB 

■0 


Subtract Bytes 
Compare words 


1 
I 


6.13 

a.i 


mm 


CB 


Compigre Bytes 


I 


8.2 
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Hexadecimal 


Mnemonic 






Operation 


Operation 






Coae 


uode 


Nam® 


r ormet aec t(on 


AOOO 


A 


Add words 


I 6.1 


BOOO 


AB 


Add Bytes 


I 6.2 


COQO 


MOV 


MOVe words 


I 10.4 


pooo 


MOVB 


MOVe Bytes 


I 10*5 


EOOO 


soc 


Set Ones Corresponding 


I 11.7 


FOOil 


SOCB 


Set Ones Corresponding, 


I 11.8 



Byte 
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ALPHABETICAL INSTRUCTIC»4 TABLE 

The following table lists the TMS990a assembly language instructions, their format, 
and the section in which they are described. They are in alphabetical order by their 
mnemonic operation code. For a listing in order according to their hexadecimal 
Iteration wi^^ isee Sectitm 24.9. See Section 5 for an ^^in^anatidn of the format. 



Hexadecimal 


Mnemonic 








Operation 


Operation 








Code 


Code 


Name 


Format 


Section 




A 


Add words 


I 


6a 


BOOO 


AB 


Add Bytes 


I 


6.2 


0740 


ABS 


ABSolute value 


VI 


6.3 


0220 


AI 


Add immediate 


VIII 


6.4 


0240 


ANDI 


AND Immediate 


VIII 


xw 


0440 


B 


Branch 




%1 


0680 


BL 


Branch and Link 


VI 


7.2 


0400 


BLWP 


Branch And Load Workspace 


VI 


7,3 






Pointer 






8000 


C 


Compare words 


r 


8.1 


9000 


CB 


Compare Bytes 


I 


8.2 


0280 


CI 


Compare Immediate 


VIII 


8.3 


03C0 


CKOF 


CIocK OFf 


VII 


9.6 


03A0 


CKON 


ClocK ON 


vn 


9.6 


04C0 


CLR 


CLeaR operand 


VI 


11.5 


2000 


coc 


Compare Ones Co^im^mfim 


III 


8.4 


2400 


czc 


Compijm ^mm Corresponding 


ill 


8.5 


0600 


DEC 


DECrement 


VI 


6.5 


0640 


DECT 


DECrement by Two 


VI 


6*6 


3C00 


DIV 


Divide 


IX 


6.7 


mm 


IliLE 




VII 


Pd^ 


0580 


INC 




VI 




Q5C0 


INCT 


INCrement by Two 


VI 


6.9 


054G 


INV 


INVert 


VI 


11.4 


1300 


JEQ 


Jump EQual 


II 


7.4 


1500 


acT 


Jump Greater Tim 


n 




mm 


OH 


Jump if I&^cNil h^ipt 


II 


7.7 


1400 


JHE 


Jump High Or Equal 


II 


7.6 


lAOO 


JL 


Jump if logical Low 


II 


7.8 


1200 


JLE 


Jump if Low Or Equal 


II 


7.9 
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1— lo V aH Ar> ■ rrtn 1 


tsA riA mnni 
1*11 ici 1 lui 11 








iLiper au on 


wpor a u on 












1 Nal 1 IC 


r Ul 11 lab 


^oi^t" inn 


1 1 nn 


11 T 


liimn 1 j^cc TKan 


11 
11 


7 10 


1 nnn 


IMP 


I Inoonrli t* i rtnfil HiiKylD 


IJp 


7 1 1 


1 "7nr\ 
J. /UU 


JiNL, 


Jump ino L>arry 


IT 
ll 


f- 


loUU 






IT 
11 




1 Qon 

J. yUKJ 




liimn Mn Ouppflnu/ 


IT 


7 14 


1 finn 

J.OUU 




liimn ("In Psifr'x/ 


11 


7 16 


1 pnn 




li imn nriri Psrifrv 


n 


7.15 


3000 


LIDCR 


LoaD CRU 


IV 


9.1 


0200 


LI 


1 nflH ImmpHiste 

1— %^bU a I Ilia • wUlObb 


VI 11 

W A, Arm 


10.1 




L IMT 

1—1 1*1 A 


1 nati Tnfnmirt^ K/laAl^ 


VIII 

V 11 1 


in. 2 






T nrim t%f4i a 

11 1 II I IdJlaLC 






mm 


1 r\L_ y\ 




VTT 

V 1 1 




rr^crn 
UZt.U 


I VA/DT 


Loaa worKspace r^otriber 


V ill 


in T 






irnrncuiaLo 






r^finn 

L^UUU 


|V|U V 


|V| LJ Vb WUTUB 


I 
1 


in &. 


DQQO 


MOVB 


MOVe Bytes 


I 


10.5 




MPY 


MiittiPi Y 


IX 

l/x 


6 10 


nsnn 




l>I^Ual>B 


VI 

V 1 






OR I 


Ik-^fl \ 11 1 II llCUlClkC 


VIIT 
y 1 11 






r\9C i 




VIT 

V 11 




U^OU 


RTWP 

rv 1 v¥r 


r\e 1 urn witn worKspoCB 


V 11 


7 It 






Pointer 






6000 


s 


Subtract words 


I 


6.1Z 


/ uuu 




ouDiract oytcs 


T 
1 








^ftt PRL 1 Ril: t-n fUnp 


ft 
11 




iE"DD 


SBZ 


Set CRU Rit to Zepo 


II 
1 A 


9.3 


0700 


SFTO 


SFT to Dnp 


VI 

* 1 


11 6 


OAOO 


SLA 


Shift Left Arithmetic 


V 


12.3 


EOQO 


soc 


Set Ones CorresDondinn 


I 


11.7 


Ffinn 




^ttt* flnon f~*nT>T>osnnrt/tif*tn 

i3tSb Ul IBS v_rUl i «5CIUUI lull i^y 


t 

1 


11 H 
















jtM 1 L r\iyi iL MriLiiiMcbiw 




J.^. J. 


OBOO 


SRC 


Shift Right Circular 


V 


12,4 


0900 


sm. 


Shift Right Logical 


V 


12.2 


5400 






IV 






wrm 




mt% 




02A0 


STWP 


STore Workspace Pointer 


VI n 


10.7 
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Operation Operation 

Code Code Name FOrrftat Secfi^ 

06C0 SWPB SWaP Bytes VI 10.8 

4000 SZC Set Zeros Corresponding ^ I 11.9 

5000 SZCB Set Zeros Corresponding, I 11.10 

Byte 

iTod Te^ m n 9.5 

0480 X Execute VI 7.18 

2C00 XOP Extended OPeration IX 7.19 

2800 XOR Exclusive OR III 11.3 
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24-11 PROGRAM ORGANIZATION 

¥im w ym^ p^Q0wm m that it i^t^^ m ^itar/Aasembier^ m ito tl 

BASIC or TI Extended BASIC program that called it, or to the master title screen. 
The program must retain the return address and must not have altered the GPL 
Workspace Registers. 

24p11«1 R^tiiirnlng When Yoi^ F^ogram Is Run AutomatieaUy 

The final instruction in your program t^n &e an END instruction followed by e label 

has been m®n1^«»teid in a OEF JraBtptfel^taru Thmit K^e program is run 
autoTTiatically wimr k loaded by the Editor/Assembler LOAD AND RUN option, the 
Editor/Assembler RUN opl^$ ^ the TI ©iOy^XC or TI Extended BASIC statement 
CALL LOAD. When your program is run automatically, the user Workspace equate 
(USRWS EQU >2QBA) is not loaded. To use this area for your Workspace Registers, 
use the following sequence. 

usRws EQU nmh 

LWPI USRW5 

You may define your own Workspace Register area instead. 

When yo££r ^fram U mm auf^mati&aU^^ 1^ trt G^^apl'te ^%i§3mming 

Language Workspace (starting at GPLWS). The return address is in Workspace 
Register 11. Do not use GPLWS as your Workspace. Instead, branch to your own 
area, save the return address from GPL Workspace Register 11, and set up your own 
Workspace. When your progran^i it %f etlearing the t^L ST^TL^ %fX^ at 

address >837C *t 6Nat there are no errors, put the return address in your 

Workspace Register 11, and return. The following program segment shows these 
steps. 



SAVRTN DATA 
MYWS 855 
STATUS EQU 



0 

20 

>837C 
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START 



LWPI MVWS 



Set up Workspace Registers. 



CLR 

MOVB 
MOV 
RT 
END 



RO 

R0,1STATUS 
§SAVRTN,R11 

START 



Prepare to return to GPL* 

Indicate no errors. 
Load return address. 
Return. 



24»Jtl.2 Returning When Your Program tn Hot ^un Automatically 

If you run your program by answering the PROGRAM NAME prompt in the 
^tor/Assembler LOAD AN0 RUN &t RUN Opiibras m mm m GALL LINK 
statement in TI BASIC, the user Workspace equate (USRWS EQU >20BA) is loaded 
and you can use the area that starts at that address for your Workspace Registers or 
you can define your own Workspace Register area instead. 

The address in Workspace Register 11 does not need to be saved unless you uae the 
Workspace Register for som^ G^m fmpm^ When you wish to return^ stn^ily clear 
the GPL STATUS byte and return. The following program segment shows these steps* 

DEF START 
STATUS EQU >837C 
START 



CLR RO 

MOVB R0,1§STATUS 

RT 

END 



Prepare to return to GPL. 
Indicate no errors. 
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Z4.11.5 OUmr Returns 

You can return to the calling program by branching to address >0070. Before doing 
this, clear the GPL STATUS byte to indicate that there are no errors and load the 
CM. WjDTkspace Regi3te|% Mlawing program segmertl: %Wm CepS. 

CLR RO 

MOVB RQ,(aSTATUS Indicate no errors, 

LWPI GPLW5 Load GPL Workspace Registers, 

B §>G070 Return. 

You can return to the master title screen by enabling interrupts, loading the GPL 
Workspace Registers, and branching through the vector >OOD0. The following program 
segment shows these steps. 

UIMI 2 Enable interrupts. 

UWl WLWf Load GPL Workspace Registers. 

BLWP ®>0D00 Return to color bar screen. 
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24.12 ERROR MESSAGES 

The following sections give the error messages that may be returned by the 
Editor/Assembler. 

24.12.1 Input/Output Error Codes 

The following table lists the Input/output error codes. 

Error 



Code Meaning 

0 ^vice name. 

1 Device is write protected, 

2 Bad open attribute such as incorrect file type, incorrect record 
length, incorrect I/O mode, or no records in a relative record file, 

3 Illegal operation;, i.e., an operation not supported on the peripheral or 
a conflict with the OPEN attributes. 

4 Out of table or buffer space on the device. 

5 Attempt to read past the end of file. When this error occurs, the 
file is closed. Also given for non-existing records in a relative 
record file, 

6 EDevice error. Cmf^ all hard device errors such m pSFll^ -SO^ bad 

7 File error such as program/data file mismatch, non-existing file 
opened in INPUT mode, etc. 



24.12.Z Error Messages Issued by GROM Code 

The following are the error messages that may be issued by code in a GKOM. 

HAME rm Lom 

NO lii^^^^RY EXP^MsW» 

I/O ERROR n, where n is the I/O error code from 0 through 7. 
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24.12.3 Errot-s Issued by the LoadN' 

The following are the error messages that may be issued by the Loader, 
^ Ei^Oim 1^, where n ia the I/o error code fmm o ihr^tifitj 

MEMORY FULL 
ILLEGAL TAG 
CHECKSUM ERROR 
DUPLICATE DEFINITION 
UNRESOLVED REFERENCE 



24.12.4 Execution-Time Errors 

The following are the error messages that may be issued at execution time. 

I/O ERROR n, where n is the I/O error code fronn 0 through 7. 

PROGRAM NOT FOUND 

ERROR CODE n, where n is the error code listed below. 

The table on the folIow-lRg Usts the errors thet may be issued when you attempt 
to run your program. 
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Code 


Meaning 


00 - 07 


Input/Output errcff 


08 


MEMORY FULL 


09 


INCORRECT STATEMENT 


OA 


ILLEGAL TAG 




CHEGH3UM ERROR 


oc 


DUPLICATE DEFINITION 


OD 


UNRESOLVED REFERENCE 


OE 


INCORRECT STATEMENT 




PROGRAM NOT FOUND 


ID 


INCORRECT STATEMENT 


11 


BAD NAME 


12 


CAN'T CONTINUE 


13 


BAD VALUE 


14 


NUMBER TOO BIG 


15 


STRING-NUMBER MISMATCH 


16 


BAD ARGUMENT 


17 


BAD SUBSCRIPT 


18 


NAME CONFLICT 


19 


CAN'T DO THAT 


lA 


LMe number 


IS 


FOR^NEKT ERROR 


IC 


I/O ERROR 


ID 


FILE ERROR 


IE 


INPUT ERROR 


W 


DATA ERROR 


w. 




21 


MEMORY FULL 


22 - FF 


UNKNOWN ERROR CODE 



F*age 445 



GLOSSARY 



Addresses: The numbering system which defines the memory locations within the 
computer. 

Addressing modei A ^my of using memory addressing. In the Editor/ Assembler, the 
addressing modes are Workspace Register addressing, Workspace Register 
indirect addressing, Workspace Register indirect auto-increment addressing, 
symbolic memory addressing, and indexed memory addressing. 

Arithmetic greater than bit: A bit in the Status Re^fclft that is set when a signed 
number is dompared with a smaller signed number* 

Arithmetic operators: The arithmetic operators are + for addition, - for subtraction, 
* for multiplication, and / for signed division, 

ASCII: Arrt^l:^! ttoidard Code for Information Interchange, The code used to 
represent data. 

Assembler: The portion of the Editor/ Assembler on Diskette A that allows you to 
d^^i^ie. m ^s^y^kiiy Language program \ti%Q object code C^l^i^Ghine language). 

Assembling; Changing an assembly language program into a machine language 
program, called object code, that can be run by the computer. 

Assembly language: A lower-level language that allows fast access to all machine 
resources, including functions not available from higher-level langi^^jeSi 

Assembly options: Options that you provide at the time of assembly. They are R 

for automatic Workspace Register generation, L for list file generation, S for a 
symbol table, and C for compressed object format. 

Assenrtbly-time constant; An expression in the operand field of an EQU directive. 

Binary: The base Z numbering system used by the computer. 

Bit I/O iimi^j^tiires P^mmit tt pmmtMm^ ^sMm eperand mrmm a 

wet^^^t^ aE^<g^^*i3H e^iiuates to a CRU bit address, relative to the 

contents of Workspade Register 12. 
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Bit-map; A way of handling graphics in the TI-99/4A Home Computer. 
Sits A Binary digiT. 
Byte: Eight bits, 

Cs^ti bit; A Status Register bit that is set by a carry of 1 from the moat 
sigr^j^Esnt bit (sign bit) of a word or byte during arithmetic and shift 
operations. 

Character constant; A string of one or two characters enclosed in single quotes. 

Character sett The ^ara^feera that are recognized by the Assefnbler/Linl<er. It is 
Usted in Section 24.7. 

Character string: A string of characters enclosed in single quotes. 

Color Tables A table in memory that defines the colors of graphics. 

Command mode: The mode in the Fditor in which you may perform special 

functions, such as copying lines, deleting lines, altering data, and the like. 

Comrr^t 0eld! An mm in '^Me^ tsi msfee «s^(*^n*S tfeat increase the readsi^^y of 
the program but that do not affect the operations of the computer. 

Compressed object code: Object code that takes up less space on diskettes. The 
code has compressed hexadecimal numbers for the tagged fields. 

Consoles The main physical unit of the computer. 

Constant; An unchanging value. The four types of constants recognized by the 
Assembler are decimal integer constants, hexadecimal integer constants, 
character constants, and assembly-time constants. 

Context switch: A change in the location of the next address to be accessed by the 
computer. 

Cwi^mi mi te^rtictions: The control and CHU inetruetlQna are Clock Off 

CCKCF), Cl^k On 0^CDfe4 Lsmi CRU (LDCR), Idle (IDLE), Load or Restm-t 
Execulion (LR^ Reset (RSET), M CPftJ Bit to Ons fSBO), Set CRU Bit to 
Zero CSBZ), Store CRU (STCR), and Test Bit (TB% 
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ContFoi instruetlonK Ptowsl ItssHm^xm Which require no operand field, 
CPUi Central PfOeessing Unit. 

CPU RAM: Central Processing Unit Random Access Memory. Used in this manual 
to describe any memory that can be directly addressed by the CPU, 

CRU: Commurticatlons Register Unit. A command-driven bit-addressable X/O 
interface* 

Debugger: A program to help you check memory locations, registers, and the like in 
order l<3 firid and eorrect any errors which may occur in ftsm pitl^srn. 

Decimal integer constant: A decirribl number from -32,768 to +65,535. Positive 
decimal integer constants greater than 32,767 are considered negative when 
interpreted as two's complement values. 

OEF/REF Table: A list of the variables which have been referred to in a DEF or REF 
statement in a program of seriies of programs. 

Destination operand: The address where the result of the performed manipulation is 
stored. 

Device Service Routine: A routine to handle communications bntween the computer 
and all external devices, such as printers, disk drives, the RS232 Interface, etc. 

Directives: Instructions to the Assembler that control the assembly process. 

Directives affect the Location Counter and the Assembler output, initialize 
constants, provide linkage between programs, and have other functions, 

DSK: Device Service Routine. 

Edit mode! The mode in the Editor in whlMi fms may create and alter tii^t* 

Editor: The portion of the Editor/ Assembler that allov^/s you to create, edit, print, 
and save files. 



editing* 
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Equal bit: A Status Register bit that is set when the two words or bytes being 



Expressions: Used in the operand fields of assembler directives and machine 

instructions. An expression is a constant or synr^bol, a series of constants or 
symbols, or a series of constants and symbols separated by arithmetic 
operators. 

Extended ^mm^kt^ bit: A Status Register pfe ^at is set sk^hm m extended operation 
(available in som& TI-99/4A Home Computers) is being executed. 

Fatal error; An error which stops the assembly process. 

Field: A ^^MQn a record. A source record consists of the label field, op-code 
field, operand f leidCs), and comment field. 

File: A group of program statements,, pbieet t?Ode, data, or the like, contained in the 
computer's «rr^6ry or ori tn efxt^PM ije^^fes m^h 80 « di«fe»tt;0- 

GPL: Graphics Programming Language. The language frequently used to program 
Command Modules. 

GROM: Graphics Read Only Memory. 

Hex^eclmal ^te^^er i^a^^^^l^ Ik s^n@ «3f l^: t@ foyr hexadecimal numerals pmc^&d 
by a greater than (>) sign. Hf^xaHecimal numerals include the decimal values 0 
through 9 and the letters A through F. 

H^Sf^itefeimall 1^ itambering system. Often as an easy represettlatitin of 

the binary numbering system. 

Immediate instructions: Format VIII instructions which contain a Workspace Register 
address followed by a comma and an expression. Use the contents of the word 
following the instruction word as the operand of the instruction. 

Indexed memory addressing: Specifies lihe rrmmory address that contains the operand. 
An indexed memory address is preceded by an "at" sign and followed by a 
register name enclosed in parentheses. 



Inatruction formats! One of nine fGrrrmis Siisfe ^ecify the way in which instructions 
are assembled to machine language. 
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Interrupt mask bits: Bits 12 through 15 in the Status Register. They determine 
What devices are permitted to ^ ^^gg^j 

Jump instructions: Format 11 instructions that use Program Counter relative 

addresses coded as expressions corresponding to instruction locations on word 
boundaries. 

Label field: The first field in a source record. It serves as a reference point. 

List file: A file which the Assembler can create. It contains a reccH-d of the 
aGsembly process. 

Loader: An assembfi? Isft^age pi^g^m osed to load asaembi^? p^ogriams into 

the Memory Expansion unit. 

Loading: The process of putting object code into the computer's memory so that it 
can be run. 

Location counter: A counter that keeps track of v/here the Assembler is in the 
assembly process. 

Logical greater than bit: A Status Register bit that is set when an unsigned number 
is compared with a smaller unsigned number. 

Machine language: The code into which assembly language is translated by the 
Assembler. The code produced can be recognized and operated on by the 
TMS9900 microprocessor. 

Memory: The storage locations or adclresses in the connputer. 

Mnemonic codes: Codes which help you to remember the instructions in asserribly 
language. 

Mode of operation: The way in whidi a mm^ ^ mci^^^^ Mfi^ hw W0U% 
OUTPUT, UPDATE, or APPEND. 

Non-fatal error: An error which does not stop the assembly process. 

Nybbte Fsup l^fesj a byte- 
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object code; The machine code into which assembly language is translated by the 
Assembler. 

Odd parity bit: A Status Register bit that is set when the parity of the result is odd 
and is reset when the parity is even. 

Op-code field: The second field in a source record. It is tf^ tspi^atlon code (a 
number, name, or abbreviation) of the task to be performed by l^iat source 
statement. 

Operand fieldi The field that stipulates the value to be operated upon or 
manipulated by the op-code. 

Operands: The numbers, expressions, or characters upon which assembly language 
insU'UCtions operate. 

Overflow bit: A Status Register bit that is set when the result of an arithmetic 
sp&mtion is too large or too small to be represented in two's complement 
representation. 

PAB: Peripheral Access Block. 

Periph^ai: Access Block: ^ s&t of kJEEHiwrns memory that ^ftnea h©stf 

devices, such as printers and disk drives, are accessed. 

predefined symbols: Symbols for addresses that are predefined in the OEF/REF table. 

Progr^ C^tl^tear V^W$^ t^&c^ ctf fche JdEt^atliEai of the next instruction in 

memory. 

Program Counter relative addressing: Used only by jump instructions. It is written 
as an expression that corresponds to an address at a word boundary. 

Pseudia-lrmt^tton: An assembly li^^ai^ statement that has the farm of an 
instruction, but is defined in terms of other instructions. The 
pseudo-instructions are No Operation (NOP) and Return (RT). 

RAM: ^Rfcn Aec^a ^demory. 
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R&^entranfe pE^^amt^^ngt h i^^r^m mUm^ khe same program code to be used 
for several differervt ^0miiom while maintaining the integrity ef the data 
used with each appiicaticini 

Register: A memory word that serves a secific purpose. Registers in Random 
A^ess 148fnory (RAM) are called "software" registers, A set of 16 
consecutive registers is called a "workspaces" 

ROM: Read Only Memory- 
Screen Image Table: A table in memory corresponding to graphics on the screen. 

Source; Th!& ttumber, address, string, etc., which is to be manipulated or 

operated upon. 

Source statements: The statements of an assembly language program. 

Special keys: Special chm-^fe^s an^ luoj^nis ^nd certain keys available for cursor 
movement when using the Editor/Assembler. 

Sprite: One of 32 characters that may be placed on the screen and moved smoothly. 

Sprite Attribute Lists A list in memory that defines the location, color, and pattern 
of sprites. 

Sprite Descriptor Table: A table in memory defining sprite patterns and sizes. 

Sprite Motion Table: A table in memory that defines the motion of sprites. 

STATUS byte, GPL: The byte at address >837C that contains status information. 

Status Register: The register that contains indications of the present status of the 
comFHJter. 

Symbol table: A table constructed by the Assembler or TI BASIC in the assembly 

process. It lists all of the symbols used in a program and contains information 
on the symbols in the program, their addresses, and their types. 

Symbol: A steli^ of s^tmn^^^ #!^st5ers (A through 1^0 tftfough 9), the fet 
of which mu9t be an alphabetic oharacter, and none of which may be a blank. 
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Symbolic Addresses: Addresses associated With locations in the program that must 
not he used in the label field of other statements. 

Symbolic memory addressing: Specifies the memory address that contains the 
operand. A symbolic memory address is preceded by an "at" sign C[^), 

Syntax ^^MtUm -A jft^rfption of the required form for the use of commands as 
related to the fields. 

Syntax: The required form for source statements, 

T-fleld value: A value Which indicates the type of addressing mode used. 

TMS99Q0 microprocessor: The chip on which the TI-99/4 and TI-99/4A Home 
Computers are based. 

Tag characters: Characters that describe the information in an object file. 

Terms: A decimal or hexadecimal constant, an absolute assembly-time constant, or a 
label having an absolute value. 

Transfer vector: Two consecutive words of memory which contain a new Workspace 
pointer and m ps^0mi ismtttm^ The cuimiiu^lS^ l^s a transfer vectcK' to 
perform a transfer of control called a context switch. 

Two's complement: The way in which negative numbers are expressed in binary in 

Undisplayable characters: Characters that have valid ASCn meanings but cannot be 
displayed on the screen. 

t^iHtesi E^ograms provided by Texas Instruments to enable quick and easy use of 
©e^Hfefi^ «©m^l^ i^pafeilities. They are VSBW, VMBW, VSBR, VMBRi VWTR, 
XMLLNK, KSCAN, GPLLNK, DSRLNK, SAVE, LOAC^R, NUMASG, STRASG, 
NUMREF, STRREF, and ERR. 

VDP RAM; Video Display Processor Random Access Memory. This memory can be 
accessed indirectly. 

Well-defined expressions: Expressions whose symbois or assembly- time constants have 
been previously defined. 
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Window: A 4Q-colunnn area that is di^ilayied on the screen. The entire file is 80 



Workspace Pointer Registers Contains the addre^ of the current softwsffe 
workspace. 

Workspace Register addressing: Speci^^ the Workspace Register that contains the 
operand. 

Workspace Register indirect addressing; Specifies a Workspace Register that contains 
the address of the operand. An indirect Workspace Register address is 
preceded by an asterisk (*)» 

Workspace Register indirect auto- increment addr^g^rtp Specifies St Workspace 
Register that contains the address of the operand. 

Workspace: A set of 16 consecutive words of memory. 
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to hexadecimal conversitJUi^ 

Debugger command 391 

> (hexadecimal to decimal conversions) 
Debugger command 390 

m 

A (add words) instruction 80 
A (load memory with ASCII) 

Debugger command ....... 367 

AB (add bytes) instruction 82 

AB5 (absolute value) 

instruction 84 

Absolute value instruction ...... 84 

Absolute code 311 

Absolute origin directive 210 

Accept tone . . « ^ . . ^ . * *^ . • r ^2 
Add bytes ^l^udttei ......... 

Add immediate instruction 85 

Add words instruction 80 

Addressing modes 56 

Addressing, CRU bit , 

immediate ............. 62 

indexed memory 59 

program counter relative 60 

symbolic memory 58 

I^Oi^^l^oe l%ef w . 57 

Workspace Register indirect . . . 57 
Workspace Register indirect 

auto-increment 58 

Adjust command 30 

Al (add immediate) instruction .... 85 

Alpha lock key , , . . 21 

ANDI (and immediate 

instruction 176 

AQRG (absolute origin) directive . . 210 
APPEND mode of operation . * # » 

ArctaniiM tOutine 256 

Argument passing with LINK 

subroutine 278 



Arithmetic instructions ........ 78 

Arithmetic instructions B3<ar^f:^s . . 98 

Arithmetic operators 49 

Arrow keys 20, 25 

ASCII values. ............ 42S 

^y©H#i^ «fif^Slves , . , 46, 208, 432 

Assembler output 235 

Assembler output directives .... 220 

Assembler output example 243 

Attentia^iMl ^eelf jfe^tion, sound . . 315 
Automatic program execution . . , 234 
Automatic program running. - ► . * 414 

B 

B (branch) instruction 107 

B (breakpoint set/clear) 

Debugger command ....... 368 

Backspace key 20 

Bad response tone 252 

BASIC PAB linkage 300 

BASIC examptet* , . . 

©AtlC support 273 

BASIC support utilities 284 

BASIC support utilities example . . 289 
BES (block ending with symbol) 

dieective- * # .* ^ > , IB 

Binary numbering system ...... 394 

Bit access example ......... 159 

Bit reversal routine t ^53^ 

Bit-map mode 334 

Bit-map mode example 336 

BL (branch and link) instruction . . 108 
Block ending with symbol 

directive .213' 

Block starting with symbol 

directive 212 

BLWP Cbranch and load Wcrks^ace 

pOfelM ti^emion 109 

Branch and link Instruction . . « . » 1(39: 
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Branch and load Workspace 

pointer instruction ........ 109 

Branch instructions 104 



Branch instructions examples. , , , 127 
BSCSUP (BASIC support) 

utilities » » n ^4 

BSS (block starting with 



symbol) directive 212 

BYTE (initialize byte) directive . . 225 

Byte organization .......... 395 

C (compare words) instruction . . . 140 

c (CRU inspeetychangej Debugger 

command 371 

CALL CHARPAT 282 

CALL Mil . * * . « f74 

mvL. Ltm m 

CALL LOAD ^ . 274 

CALL PEEK 281 

CALL PEEKV 281 

xzMUL pom¥ mn 

t^msmtte DSR Fmifcine 

CB (compare bytes) instruction. . . 142 

CEND (common segment end) 

directive 216 

Changing objee^ * . ^ * • . * Ml 

Character set 47, 428 

Character strings ........... 55 

CHARPAT subroutine 282 

Chime sound example 321 

CI (compare immediate) 

instruction 143 

CKOF (clock off) instruction .... 157 

CKON (clock on) instruction , . . . 157 

Clear instruction 184 

Clock off instruction . , 157 

Clock on instruction 157 

OLIBe pab opNOodt * ^ 

CLR, (clear) instruction 184 



COC (compare ones corresponding) 

instruction , * . * ^ ^ * . ^ * . * 144 

Color tslble, bit-map mode 335 



graphics mode 329 

Color, graphics, and sprites 325 

Commands, D^M^^W * .... . . - 

Comment field arid line 48 

Comments ,^ « , . 46 



Common segment directive. . . 215 
Common segment wi^ dftreetto . . 

Compare bytes instruction , , , . . 14Z 

Compare immediate instruction . . 143 



Compare instructions 138 

Compare ones corresponding 

instruction 144 

Compare words instruction . . . « # MQ 
Comimp© z#jms corresponding 

instim^lfln . 146 

Compressed object code 240 

Computer differences .... 20,125,233, 

334, 366 
Cort^ant Mtialization 

directives . 224 

Constants, assembly-time 51 

character §1. 

decimal integer 5Q 

hexadecimal integer ........ 50 

Context switch 45 

Context switch example ...... 129 

Control instructions 148 

Controller access, sound 321 

Convert floatNf point to 

integer , ^ * 261 

Convert infe^^rr fco fioaitfeng 

point 261 

Convert number to string 254 

Convert atring to number ...... ?61 

Qopy comrttand ^ 

COPY (copy file) directive ..... 22^9 
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Cosine routine • , , . • 256 

CPU RAM PAD u^ . ....... • 404 

Cl":^^^ HMIi iiWiple 323 

CRU allocation 406 

CRU bit addressing 61 

CRU examples 158 

CRU insb-uctiohs . 148 

CRiJs meffnory, and intsirupt 

structure ^4 

CSEG (common segment) 

directive 215 

VM^' Ccompare zeros 

corresponding) instruction .... 146 

D 

DATA (initialize word) directive . . 225 

Data segment directive 217 

Data segment end directive .... 219 

Debugger 3^ 

DEC (decrement) instruction . . , , , 86 
Decimal to hexadecimal conversions 

C) Debugger command 391 

Decrei1rt«rtt ^ IWo instruction , » . , 87 
Decrennmii hy two instruction 

example 101 

Decrement instruction 86 

Decrement instruction example ... 99 

87 

DEP* (external definition) 

directive 227 

DEF/REF table 307 

Define assembly-time constant 

224 

Define Mended operation 

directive 233 

Delete character key ......... 25 

Delete command 29 

Delete key 20 
Delete line key 20, 25 

DELETE PAB op-eode . 297 




DEND (data segment end) 

directive . . . ^ . *v * * • 219 
Device Service Routine (DSR) 

operation 299 

Device Service Routines (DSRs) . . 291 

Devices, memory-mapped ...... ^2 

Direct access to sound ..... • 317 

DirecttvBs fehatt aftot 

assembler output 220 

Directives that affect the 

location counter 209 

Directives that initialize 

constm^ « . « . ^ . %M 

Directives that link programs . . . 227 
Directives, assembler , . . 46, 208, 432 

Directives, miscellaneous ...... 233 

DISPLAY file type 292 

DIV (divide) instruction . 88 

D0EJ3 C^dummy origin) directive * . ^ffi: 

Dov/n arrow key 20 

D5EG (data segment) directive . . . 217 
DSR (Device Service Routine) 

openal^isn ».»...•.«.. • . 299 

C^H input/output modes ..«.•. 1^ 

DSR memory use 300 

DSRLNK (Device Service Routine 

link) utility 262 

l!5ammy Wti0} directive ....... 

Duplicate definitions 414 

Duration control, sound 316 
DXQP (define extended 

operation) directive ....... 233 

E 

E (execute) Debugger commansi < ^ 373 

Early clock sprite attribute, .... 339 

Edit command 26 

Edit mode 24 

Bm eption . • . 2> 

EditcH' use ^ 
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END (program &r^^^mMmi . . . 234 

Ehter 1^ 74, is 

Entry points . * • 414 

EQU (define assembly-time 

constant) directive 224 

Equates, TI Extended BASIC .... 415 
ERR (error reponing) utility . » . . 

Ertor cod^ and messages . . . 229, 236, 

254, 288, 298, 299, 311, 443, 444 



Error equates, TI Extended 

BASIC / • • • 

E^« ^mm mmm^^ Mmitwe , . 213 

Example, asssemblisr dutput .... 243 

bit-map mode 336 

chime sound 321 

context switch # . 

copy file directive. ....... 230 

crash sound . 323 

crash sound output. 243 

execute 136 

extended operation ....... 

file access 

gitW . * 230 

listing 243 

load and move instructions . . . 172 

object code 245 

set CRU bit to one . 159 

set CRU bit to zero 159 

shift 204 

sprite motion 346 

subroutine 133 

toa^ Mt - 16Q 

Tt S^IC m^iKirt utiUties . , . laS 

Tombstone City 230 

Workspace Register shift .... 204 
Examples, arithmetic 

CRU 158 

graphics and sprite • 342 

jump and branch ......... 127 



sound . . u '^l. 

speech ^ . . i It 355 

TI BASIC 283 

Exclusive or instruction * * . » . , . 180 

Execute example 136 

Execute instruction 124 

Ex©^g0 pmm^^ muttne ...... 252 

Ejit^^^ Mm t . 400 

Exponent routine ........ ^ . 255 

Expressions 49 

Extended BASIC equates 415 

^i^irs^^ ^^tC loader . 410 

ExKerSiid operation iragirtiiliaw * » . 125 

Extended utilities 250 

External definition directive .... 227 
External reference directive « . » ► 

External references ......... 413 

F 

F (find word or byte) Debugger 

command 374 

Field, comment 48 

label ................ 47 

operand 48 

operation 48 

File access example ......... 303 

#iaracteri9tics ......... 291 

File default «... 3DQ 

File management .......... 291 

File memory use 300 

File specification 33 

File l^p® ^Kw.aw. ^2 
Find emmmin^ ..««.»....... H'^ 

Floating point addition ....... 259 

Floating point compare 260 

Floating point division 259 

Floating point multiplicatiort * . * * §M 
Roating point subtraction. ..... 

Force load directive 231 

Format* source statement 46 
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Formats, instruction 65 

Frequencies, souRd, , . » * * • • - 
Frequency specification, sound . . . 3i4 

G 

G (GROM base change) Debugger 



command Jf^ 

Game exampie . , , . . 230 

Gener^ aa^fiessing madea 56 

Generator frequencies, soyncl ♦ » * • 318 

Get string space routine 252 

GPL routines 252 

GPLLNK pJ^L Si^) amity ..... 231 

lE^dfiAilbs ^rt^ sf^ite examples. . . . 342 

Graphics mode 329 

Graphics, color, and sprites 325 

Greatest integer function 255 

symbol . . . 
GRMRD (GROM read data address) 

symbol • 271 

GRMWA (GROM write address) 

symbol 2^ 

GRMWD (GROM write data address) 

symbol 271 

GROM , * 401 

GROM access . 270 

M 

H ChexadecimM tt^l^^metic) 

Debugger command 392 

Hexadecimal numbering system . . 395 
Hexadecimal to decimal conversions 

09 ^teioig^er command ..... 390 
Home command ............30 



I 

I (inspect screen location) 

Debugger G^fifi#fS**Ei , , ^ ^ * * 176 
IDLE instpuetican. .......... 157 



IIJT (program t^feftSHtoK^^ 
directive 

Immediate addressing 62 
INC (increment) instruction ..... 90 

Increment by two instruction 91 

Increment instruction , , , 9X3 

Increment instruction examE^© • • - - 
INCT (increment by two) 

instruction . S"! 

Indexed memory addressing 39 

INIT subroutine 274 

Ir^^^^gll^, l^i! iiE^ate 225 

Imtt&ikm 41ree*l)s® ....... 

Initialize word directive 225 
INPUT mode of operation ..... 292 

Input/Output op-codes ....... 295 

lim^t ^mm^^ key M,. 2!i 

Insert command 29 

Insert line key* 20, 24 

Instruction formats 65 

Instructions, alphabetical list. . , . 437 

arithmetic 78 

branch 104 

cofT^ars ............. 13S 

control 148 

CRU 148 

hexadecimal list 434 

^m^- 104 

imd move 

logical 174 

machine . 46 

set-up 18 

Workspace Register shift .... J,$^ 

mrtmiM. tm type ........ 2s»z 

Interrupt handling , , 407 

Interrupt, memory^ .and CRU 

structure . i . . « , * ...... 404 

BMW im^w^^m * , 182 

Involution routine ...... ^ .. . 
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J 

■JEtQ (Jump if equal) instruction . . . 110 
J^f Ifismp if greater than) 

instruction Ill 

JH (jump if logical high) 

instruction 113 

JHE (jump if high or equal) 

JL (jump if Iqgjcial Ipw) 

instruction * . . 114 

JLE Cjunnp if low or equal) 

Ifisl^^y^cirt 11$ 
JLT (jump if less than) 

instruction , , , 116 

JMP (unconditionM iurn,p) 

instruction 117 

JNC (jump if no carry) 

Instruction ............ 118 

JNE Qump if not equal) 

instruction 119 

JNO (jump if no overflow) 

instruction 120 

irsstrismm • . , . 122 

JOP (jump if odd parity) 

instruction , 121 

Joystick use 230 

aump if eqml M^m^m * ... * * lit) 

3ump if ^^^lir Ittatruction . . Ill 
Jump if high or equal 

instruction . , 112 

Jump if less than instruction .... 116 

^ump if logical high instruction . . 113 

^mip fi fcofjglcal low instruction ... 114 

Junrtp if low or equal instruction . . 115 

Jump if no carry instruction . , . . 118 

Jump Lf no overflow instruction . , 120 

Jump if not equal instruction. . . . 119 

Jump if qdd parity instruction . . . 121 

Jump iinyaaBStte exampies . . • . » XW 

Jump instnicEions 104 



122 



K 

K (find data not equal) 

Debugger command ....... 377 

Keys, special « 20 

KSCAN (keyboard scan) utility . . . 250 

L 

Label field 47 

LDCR (load CRU) instewtian * r . 
Left arrow key . Ws/M 

LI (load imme^laW Instruction . . 163 
LIMI (load interrupt mask 

immediate) instruction 164 

Line numbers 26 

LINK subroutine 277 

Linking Loader 305 

Linking a PAB in TI BASIC , . . . 300 

Linking directives 227 

LIST directive 221 

Listing e^^mple 

Listing, source ............ 

Load and run option 36 

Load CRU instruction 151 

LOAD (force load) directive .... 231 

Load immediate instructilfrTA * t * * Hi 

Load instructions 161 

Load instructions example ..... 172 
Load interrupt mask immediate 

instruction 164 

Load lower-case character set . . . 254 
Load option .............. 22 

Load or restart execution 

instruction 157 

LOAD PAB op-code 296 

Load small capitals character 

set 252 

li^^ j^l^^fee^ ^aracler set , . • . 252 

LOAD sqbf outine 274 
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Load Workspace pointer immediate 

iim^mc2tion . IM 

Loader 305 

Loader error codes « j ... ^ *- * . . • 311 

LOADER utility 262 

Loader, TI Extsn« B^IG .... M 

Location eouitter directives * , . . . 209 

Logical instr-UfetiGns * • * i* 174 

LREX (load or restart execution) 



instruction , 157 

LWPI (load Workspace pointer 

immediate) in^wifEW * . * » X65 

M 

M (memory inspect/change) 

Debugger command 378 

hlai^lne in^^£:f^iS' . ^ ......... $g 

Matshiw lariigwaige 15, 242 

Magnification of sprites ...... 340 

Mathematical routines 254 

Memory allocation with the 

Loader 303 

Memory Expansion unit 400 

Memory map, Editor/Assembler . . 403 

general case • . . . . 399 

LOAD AND RUN option .... 400 

Memory Expansion unit, 

Editor/Assembler Loader . . 411 

Memory Expansion unit, TI 

Extended BASIC Loader . . 412 

Memory organization 398 

Memory use by TI Extended BASIC 

and Editor/Assembler 410 
M^qa^ OTU, and interrupt 

structure . . , 4Q4 

Memory, directly addressable . . , 398 

Memory-mapped devices 402 

MiseellEKiepisa -^semM^^m. * %: * . . • 235 

Mrwpnip:TlS • * ^ 15 

McK^ of jope^ation-, ^ ....... . 292 



Mode, command 26 

edit 24 
Modes, addres^ng S6 
MOV (move word) instruction . . . 166 
MOVB (move byte) instruction . . . 168 

Move command , 28 

Move instFtftitW^ lil 
Move instei^ii^s example , , . . « 172 
Move word instruction ....... 166 

MPY (multiply) instruction 92 

Multicolor mode 331 

Multiply instruction 92 

N 

N (move block) .D#|^geif 

command 380 

Natural logarithm routine 256 

NEG (ne^t^l iRs^uetiOT 94 

Negative numbers in 

two's-complement notation . . . 397 

Next window key 20, 25 

No operation pseudo-instruction . . 206 

H0 mmB list ^rasti)^;. .... ^ * 220 

Noise specif iGfit^3c»T, sound ..... 315 
NOP (no operation) 

pseudo-instruction ^ 206 

NUMASG (numeric assignment) 

utility. , , , 284 

Numbering sterns . 394 

NUMREF (get numeric parameter) 

utility %$6 

O 

Ob}ee fe m^^- ^ 

Object csa^ ?^rople 245 

Object code, changing 241 

compressed format 240 

Object tag use by TI Extended 

l^IG Editor/ Assembler . . 414 

Obji^ tags 507, 309 

OPEN PAB op-code 29^ 
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t)p)efatimi fieM ^ 4? 

Operation specification, sound < . # 514 

Operators, arithmetic 49 

Option specification 33 

Options , , * V 

O^^&m ^ the Hi^tor/^ssembler . . « ^ 
ORI (or immediate) inBtruption* . . 178 

Output example 243 

OUTPUT mode of operation .... 292 
Output, assembler 233 

P 

P (compare memory blocks) 

Debugger command 381 

PAB (Peripheral Access Block) 

definition 293 

PAB op-Godes 2^5 

PAD symbol 265 

PAD use . 404 

PAGE (page eject) directive .... 221 

Page title directi^ . . . ^ * . » . ^ 
Passing arguments with LINK 

subroutine 278 

Pattern descriptor table, 

bit-map mode 334 

graphics mode ....w^tinc*^ 

multicolor mode * , * 331 

PEEK subroutine. .......... 281 

PEEKV subroutine 281 

PEND (program segment end) 

directive . 213 

PeriocJiG noise 315 
Pe^^^Wai ^^jss Block (PAB) 

definition 293 

POKEV subroutine 282 

Poking data with LOAD subroutine 274 
l^^fined symbi^f » * * , f 11% 
PfMu '^i^0Mrs. * * s- *****■..•-.- 31 
Program cotintar register .«.••..?? 



Program counter relative 

Program 8i*d fceetive ZM 
Pl'^^fpStfti identifier directive .... 223 
Program linking directive 227 
Program organization 440 
program segment directive . . * . • fl^ 
Pi^^am^^egment end directive . ^ 215 
PSEG (program segment) 

directive .... ^ . 214 

Pseudo-instructions 46, 206 

Purge option 32 

m 

Q (quit Debugger) Debugger 

command 382 

Quit key 20 

a 

R (inspect or change WP, PC, 

and SR) Debugger command . . 383 

Radix 100 notation . 279 

READ PAB op-code 'Mf 
REF (external reference) 

directive 228 

REF/DEF table 307 

References, external * . . 413 

utility . . , . 414 

Registers . 39 

Regi^tes, write-only ..... 326 

Relocatable origin directive . * » ^10 

Replace command 27 

Reset instruction 157 

PAB 

le ...... .....«'■;■ 

Return key 20, 24 

Return pseudo-instruction 207 

Return with Workspace pointer 

'j^j^tssjening . *.*••■■■>>. .r. 440 
Right arrow key 2Q, 25 
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Roll-down key 20, 25 

RoU-up key ^ « « . 2D, 25 

. , * mi 

ROM routines 259 

RORG (relocatable origin) 

directive 210 

Routines, GPL 252 

Ff^^h^fTtatical 

ROM 259 

RSET (reset) instruction 157 

RT (return) pseudo-instruction . , * 207 
RTWP (return with Workspace 

IHcimefel in^t»^tto 123 

Run program file option 38 

S 

i (meismfte in i^p mode) 

Debugger command ....... 364 

Save option 30 

SAVE PAB op-code ^ 297 

SAVE utility 420 

SB (subtract bytes) instruction .... 96 

SBO (set CRU bit to one) 

instruction • 152 

SBZ (sRt CRU bit to zero) 

instruction 153 

SCAN symbol 264 

SCRA7W RECORD PAB 

op-code 297 

Screen image table, 

bit-map mode 334 

graphics mode 330 

multicolor mode ......... 331 

text mode 333 

Secondary extepftsd- tB^mm^ 

directive 232 

Set ones corresponding 

instruction ............ 186 

Set CRU blit m mmm^ • . . . » 



Set CRU bit to one in^ruction . . » 152 



Set CRU bit to zero example . , - tW' 

Set CRU bit to zero instruction - . 153 
Sel W ®f>e instruction 185 
Set zeros correspE^^^lBig 

instruction , , 190 



Set zeros corresponding, byte 

KTiO M me) instruction . . ^ * M 

Set-up instructions 18 

Shift instructions » # - . 194 

Shift instructions example , , , , . 204 

kiS^mMmt ............ 200 

Shift right arithmetic 



instruction 196 

Shift right circular instruction . . . 202 

Shift right logical instruction. . . . 198 

Show command 

Sine rqsK&rei .............. fHi 

Size of sprites , * 340 

SLA (shift left arithmetic) 

instruction 200 

SQC £^ mi^ coiij^esponding) 

imt^nmticin . 186 

SOC8 (set ones corresponding, 

byte) instruction 188 

Sound . 312 

S^nd attenuation specification . . 315 

Sound controller access ....... 321 

Sound duration control 316 

Sound examples 321 

Sound frequency specification . . . 314 

Sound generator frequencies .... 318 

Sound noisfe ^ecitication ...... M$ 

Sound operation specification, , , . 314 

Sound table . ^ . . . . . 313 

Sound, direct access 317 

Source listing 235 



Source sta^s^^l W^m^. ^ 
tejFCB statement length ....... 47 

Speech 349 
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Speech addresses 351 

Speeesh cheekihg to see if the 

Synthesizer is attached , . , . , 

Speech commands . , , . 351 

Speech data reading « i »■ * . y . . 353 

Speech examples. ..*...«... 355 
Speech Synthesizer resident 

vocabulary 422 

S^eseeh fiitTEnii # ^ . . « . . . 349 

Sprite and graphics &^mp^-^ , . - 342 

Sprite attribute list 338 

Sprite descriptor table 339 

Sfirite magnilfeaiiesrf 340 

^irife® wtlBffi s?carnple ....... 346 

Sprite motion table 340 

Sprite size 340 

Sprites 338 

Sprites, graphics, and eol'^P . . . i . 3.25 

Square root routine 255 

SRA (shift right arithmetic) 

instruction 196 

SRC (shift right circular) 

instruction . * » * - 202 

SREF (secondary external 

reference) directive 232 

SRL (shift right lQg[icaJi) 

instruction 198 

STATUS byte 250 

mMtiM op-cod® 

totas ^ 40 

Status register bits affected 

by instructions 41 

STCR (store CRU) instruction ... 154 

'"Ernes' .^^f kjjs^ru^tto «■ " 169 

$imm y^mkspace pointer 

instruction 170 

STRASG (string assignment) 

utility 28^ 

STRREF (get atrttii f^ameter) 

utilUy. 287 



STST (store status) instruction . . . 169 
STWF CsfeSt^ W^kspace pointer) 

instruction 170 
Subprogram use by TI Extended 

BASIC and Editor/AssexnWer . . 414 
Subroutine example 127, 153 

Subtract bytes instruction 96 

Smmp b^fees instruction 17i 
Switch, context , * ^ 
SWPB (swap bytes) ii^lftt^tlW . . , 171 
Symbol, GRMRA 270 

GRMRD 271 

tTOdWD mi 

PAD , . 265 

SCAN 4 - n * - . 264 

UTLTAB 264 
VDPRD 

VDPSTA 269 

VDPWA 266 

VDPWD 267 

Symbolic memory addressing ..... 58 

Symbols 52 

Symbcrl^y predefined • . . . S>j 31^, E64 

Syntax coB«i^i®ns » 46 

SZC (set zeros c»«S|Krting) 

instruction , . 190 

SZCB (set zeros corresponding, 

^tisf) instruction ......... 192 

T 

T (trade screen) Debugger 

command 385 

Tab key 20, 25 

Tag use by TI Extended BASIC 

and Editor/Assembler 414 

Tags, object ..... ^ «... . 3Q7, 309 

Tangent MiMne ^ . 256 

TB (test bit) instruction ....... 156 

Terms ..54 
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Test bit example 160 

Tm^ bit insti^ii^loe 

tEXt (initialize text^. direetive . til 

Text mode 333 

TI BASIC examples . . . 5^. « * * ^ . 283 

TI BASIC PAB linkage 3QQ 

TI BASIC support 273 

Ti;^KP^^^tt .utlUfciee ..... 284 
Tl ^MlPampport utilities 

example 289 

TI Extended BASIC equates .... 415 

TI Extended BASIC loader 410 

TITL t^M^B mM diretitive . * . . . 222 

TtSiirt^l^Fit C^Ht ....... i . 230 

Transfer vectors , , . , 45 

Two's-complement notation 

(negative numbers) 397 

U 

U (toggle offset to and from TI 

BASIC) Debugger command . . , 3B6 

Unconditional jump instruction . . , 117 
UNL (no source list) 



UPDATE mode of operation , 
Using the Editor/ Assemble? * » * * 

Utilities 

Utilities example, TI BJWi:^ 

support ^.^t;. 
Utilities, extended*: * .* * ^ , * ^ * 

TI BASIC support 1^, 

VDP RAM access 

Utility references 

Utility re:feren©et fe^ tl Extended 

BASIC and EditorMssambler . 
Utility, SAVE . . 
UTUTAB symbol . . . * » . * * . 



V {VDP base Qftmge} OBhOg^et 



292 
. 21 
246 

289 
250 

284 
248 
414 

4i4 
420 
264 



260 
260 
266 



Value stack addition 260 



Value slack di^islm , .. ..... 

Value stack multiplication . . . 

Value stack subtraction 

VDP access 

VDP RAM access utilities . . . 
VOP write-ofii^ f^segia^fil 4 * i * 
VDPRD (VDP read data address) 

symbol . 

VDPSTA (VDP read status 

register) symbol 

VDPWA CVDP write addfess) 



267 
269 



3 



VDPWD (VDP write data 

symbol 

Vectors, transfer 

atltUy i . , » * # *. .* * 
VMBW (VDP RAM multiple byte, 

write) utility , 

VSBR (VDP RAM single byte 

read) utility ........ ^ . 

VSBW (VDP RAM 

write) utility 

VWTR (VDP RAM write register) 

utility. .............. 



268 
. 45 

249 

248 

248 

248 

249 



W 

Debugger command . * * * •* * ? 388 

Well-defined expressions 49 

White noise 315 




Word organizKtlatt * ^. * * «. t * . . 396 

Workspace 45 

Workspace pointer register 39 




Register indireet 



E0mmand;. , 
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Workspace Register indirect 

sUJ;tMn<sr^ri^# i^^iN^^t^ . . . • 58 
WtH-kspMi^ f^ister shift 

instructions • . . • » 194 

Workspace Register shift 

instructions example 204 

Workspace subroutine example . . . 127 

W^itte-dnly Registers in VDP . . * - 326 

WRITE PAB op-eode 296 

X 

X (change X bias) Debugger 

command ^ • 389 

X (execute) instruction . . . ^ . . • X24 

XMLLNK utility 257 

XOP (extended operation) 

instruction 125 

XOR (exclusive or) instructim * . » 180 

Y 

Y (change Y bias) Debugger 

command 389 

z 

Z (change Z bias) Debugger 

cpmmand ............. 389 
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HOME COMPUTE^R SOrrWARE MEDIA 



Texas Instruments Incorporated extends this consumer warranty only to the original 
consumer purchaser. 

WARRANTY COVERAGE 

This warranty covers the electronic and case components of the software program 
storage media. These components include all semiconductor chips and devices, 
diskettes, plastics, boards, wiring and all other hardware contained in this storage 
media ("the Hm4^mi0% This limited wamm^ t^ms extend to the programs 
contained in the storage media and the accompanying book materials ("the 
Programs"), 

tfm HsTdware k wsn'rantBd c^ins^ ms^ttriGikit^ i&t^atbf® m^ierfals or 

construction. THIS WARRANTY IS «10 ff* TME HliRtWAm^ HAS BEEN 
DAMAGED BY ACCIDENT, UNREASONABLE USE, NEGLECT, IMPROPER 
SERVICE, OR OTHER CAUSES NOT ARISING OUT OF DEFECTS IN 
MATERIALS OR WORKMANSHIP. 

WARRANTY DURATION 

The Hardware is warranted for a period of three months from the date of the original 
purchase by the consumer. 

WARRANTY DISCLAIMERS 

ANY IMPLIED WARRANTIES ARISING OUT OF THIS SALE, INCLUDING 
BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF 

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, ARE 
LIMITED IN DURATION TO THE ABOVE TH^E-R^WtH PERIOD- TEXAS 
INSTRUMENTS SHALL NOT BE LIABLE FOR LOSS OF USE OF THE 
HARDWARE OR OTHER INCIDENTAL OR CONSEQUENTIAL COSTS, 
EXPENSES OR DAMAGES INCURRED BY THE CONSUMER OR ANY OTHER 
USER- 

Some stmise not allow the exclMsion or limitation of implied warrantties or 
consequential damages, so the above limitations or exciuaions may not appiy to you in 
those states. 
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THREE-MONTH LIMITED WARRANTY 



LEGAL REMEDIES 

This warranty gives you specific legal rights, and you may Ulm ^SVe Other rights that 
vary from state to state* 



PERFORMANCE BY TI UNDER WARRANTY 

During the above three-month warrarfl^y p^&d, defective Hfe^»re mtU fafe i^iaiS^ 
when it is returned postage prepaid to a Texas Instruments Service Facility listed 
below. The replacement Hardware will be warranted for three months from date of 
replacement. Other than the postage requirement, no charge will be made for 
replacement. 

TI strongly recommends that you insure the Hardware for value prior to mailing* 



TEXAS INSTRUMENTS CONSUMER SERVICE FACILITIES 



U.5. Residents 

Texas Instruments Service Facility 
P.O. Box 2500 
Lubbock, Texas 79408 



Canadian Residents only 

Geophysical Services Incorporated 
41 Shelley Road 

Richmond Hill, Ontario, Canada L4C5G4 



Consumers in California and Oregon may contact the following Texas Instruments 
offices for additional assistance or information. 

Texas Instruments Consumer Service Texas Instruments Consumer Service 

831 South Douglas Street 6700 Southwest 105th 

El Segundo, California 90245 Kristin Squares $tMe 110 

(213) 973-1803 Beaverton, Oregon 97005 

(503) 643-6758 



IMPORTANT NOTICE OF DISCLAIMER REGARDHslG THE PROaRAMS 

The following should be read and understood before purchasing and/or using the 
software media. 
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thre:e:-mqnth limited warranty 



n does not warrarit tt^at the Programs will be free from error or will meet Ehe 
specific requirement of mstwmer* The amyms s^minM ns^^M^ 
responsibility for any decision or actions taken based on information obtained 

using the Programs. Any statements made concerning the utility of the Programs are 
not to be construed as expressed or implied warranties. 

trnxm. wmtmxmmrtm uumm no warranty, eith^ o^miK©^ im 

IMPLIED, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES 
OR MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, 
REGARDING THE PROGRAMS AND MAKES ALL PROGRAMS AVAILABLE 
SOLELY ON AN "AS IS" BASIS. 

IN NO EVENT SHALL TEXAS INSTRUMENTS BE LIABLE TO ANYONE FOR 
SPECIAL, COLLATERAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES IN 
CONNECTION WITH OR ARISING OUT OF THE PURCHASE OR USE OF THE 
PROGRAMS AND THE SOLE AND EXCLUSIVE LIABILITY OF TEXAS 
INSTRW4ENTS, REGARDLESS OF THE FORM OF ACTION, mmJL NOT 
EXCEED THE PURCHASE PRICE OF THE SOFTWARE MEDIA. MOREOVER, 
TEXAS INSTRUMENTS SHALL NOT BE LIABLE FOR ANY CLAIM OF ANY 
KIND WHATSOEVER BY ANY OTHER PARTY AGAINST THE USER OF THE 
PROGRAMS. 

Some staler sJq not allow t\m li^feitUlS^n or limitation of implied warranties or 
conr.equential damages, so the above limitations or exclusions may not apply to you in 
those states. 
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ADDENDUM 

Editor/Assembler Owner's Manual 



Please mark the following changes in your manual. 



Page 
42 
92 



104 
127 
168 

262 



289 



328 
335 
335 
415 
416 
420 



Section 

3.1.3.1 

6.10 

6.14.2 
7.20.1 
10.5 

16.2.4 



17.2.6 



21.1 

21.5.2 

21.5.3 

24.4.8 

24.4.8 

24.5 



465 



Index 



Description 

In the last sentence of the first paragraph, change "least" to "most". 
In the second line of the example explanation, change "value of ADDR" 
to "value in ADDR". 

In the example, change "MOV *11,1" to "MOV *11 +,1". 

In the next-to-iast line, change ">2220" to ">C220". 

In the example, change ">2A4r' to "@ >2A41" and "Register 3" to 

"Register 2". 

(Add the following.) NOTE; Some devices modify the GROM read 
address. RS232 and TP are known offenders. If your program accesses 
these devices, save the current GROM address (see section 16.5.2) 
before the I/O operation, and restore it (see section 16.5.1) after your 
program has accessed the device. Otherwise, the program will not be 
able to return to the Editor/Assembler or BASIC or to perform a 
BLWP ©GPLLNK properly. 

Change line 130 in the BASIC program to 

CALL L0AD("DSK1.BSCSUP","DSK2.STRING0") 
This assumes that you have entered the source file on the next page by 
means of the Editor, saved the file as DSK2.STRING, and run the 
Assembler, using DSK2. STRING for a source file and producing 
DSK2.STR1NG0 as an object file. 

The default for VDP Register 7 is >07 in Tl BASIC and Extended BASIC. 
In the last paragraph, change ">00 or >04" to ">03 or >07". 
In the last paragraph, change ">00 or >04" to ">7F or >FF". 
Change the second instance of GRMRD to "GRMRA EQU >9802". 
Change the second line to "NUMREF EQU >200C". 

(Add the following.) NOTE: A program to be saved using the SAVE utility 
should not have an entry point defined on the END statement. If you 
want to save the Tombstone City game in memory image format, you 
must first change the last line from "END START" to "END" and then 
reassemble the program. Otherwise, the game starts to run as soon as 
it is loaded, and you will not have a chance to execute the SAVE utility. 

VDP Write-Only Registers: add page 267 to references. 
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